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1. AP-Router SDK introduction 


AP-Router SDK is a Linux development platform customized to provide a unified platform for 
embedded systems based on RLX processor cores. 
AP-Router SDK’s directory lists as follows: 
RLXLinux 
> bootcode_rtl8196c_98 or bootcode_rtl819xD 
> rtl819x-sdk-v2.x/rtl8 19x or rtl819x-sdk-v3.x/rtl8 19x 
Directory bootcode_rtl8196c_98 deposit bootloader source code of RTL8196C, RTL8196CT, 
RTL8198, RTL8198T for AP-Router SDK while rtl819x-sdk-v2.x/rtl8 19x stores applications and linux 
kernel. 
Directory bootcode_rtl819xD deposit bootloader source code of RTL8196E, RTL8196D, 
RTL8197D for AP-Router SDK while rtl819x-sdk-v2.x/rtl819x stores applications and linux kernel. 
Directory bootcode_rtl8198c deposit bootloader source code of RTL8198C for AP-Router SDK 
while rtl8 1 9x-sdk-v3.x/rtl8 19x stores applications and linux kernel. 


Note: RTL8198 and RTL8954C are SoC sharing the same SDK. The Major difference between 
RTL8198 and RTL8954C are BSP and VoIP capabilities. For more VoIP details please refer to VoIP 
SDK Manual. 

RTL8198C is only supported by Kernel 3.10 now. 
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2. Compile AP-Router SDK 


We assume that AP-Router SDK is stored at root directory (‘/’), the source code directory as 
“1t18 19x”. 


2.1. Compile Environment 
CentOS Linux release 7.1.1503 [Recommend] 


CentOS release 5.8 (Final) 


Note: 
1) x64 environment need to install 1a32-libs first to support compile tools. 
On Red Hat/Fedora , run yum install -y glibc-2. 14.90-24.fc16.6.i1686 
On ubuntu, run sudo apt-get install ia32-libs 


2) Please use bash as default shell. 

On some new linux distributions such as Ubuntu12.04, it may use dash as default 
shell(11 /bin/sh will see /bin/sh->dash). For Ubuntu, try sudo dpkg-reconfigure dash and 
select no. 

3) Please install usually used tools and librarys: zlibl g-dev bison flex gawk cmake 
4) automake should be 1.14 or higher version 


2.2. Compile bootloader 
Steps to compile bootloader are as follows: 
Step 1, enter bootloader directory. 


For RTL8196C, RTL8198, RTL8196CT, RTL8198T, RTL8954C: cd bootcode_rti8196c_98 


For RTL8196D, RTL8197D: cd bootcode_rtlS&19xD 

For RTL8197D+8367RB: cd bootcode_rtl8197d_8367r 
For RTL8881A: cd bootcode_rtl8S881A 

For RTL8198C: cd bootcode_rtl&198c 

For RTL8197F: cd bootcode_rtlS197f 


Step 2, choose default configure file. 


For 8196C and RTL8196CT: cp def-rtl8196c-config .config 
For 8198 and RTL8198T: cp def-rtl8198-config .config 
For 819xD: cp def-rtl8196d-config .config 
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For 8954C v200: cp def-rtl89xxc-v200-config .config 


For 8954C v4xx: cp def-rtl89xxc-v4xx-config .config 
For 8198C cp def-rtl8198c-8954e-config .config 
For 8197F cp def-rtl8197f-config .config 


Step 3, appoint the compile toolchain and make default configure file chosen effective. 
0) Appoint the compile toolchain. 
One method to appoint the compile toolchain as follows: 


a. find the toolchain at .../rtl8 19x/toolchain. 
rsdk-1.3.6-418 1-EB-2.6.30-0.9.30 is for RTL8196C, RTL8196CT, RTL8196E 
and RTL8196EU 


rsdk-1.3.6-528 1-EB-2.6.30-0.9.30 is for RTL8198, RTL8198T and RTL8954C. 


rsdk-1.5.5-528 1-EB-2.6.30-0.9.30.3-110714 is for RTL8196D, RTL8197D and 
RTL8881A. 


b. for rtl8198c ,please uncompress the toolchain 
msdk-4.4.7-mips-EB-3.10-0.9.33-m32t-131227b.tgz 


c. for rtl8197f ,please uncompress the toolchain 
msdk-4.4.7-mips-EL-3.10-u0.9.33-m32t-140827.tar.bz2 


d. add the exact toolchain to the environment variant PATH. 
Here we take the toolchain for RTL8196C as an example. 


Input command as follows: 
PATH=$PATH. .../rtl819x/toolchain/rsdk-1.3.6-4181-EB-2.6.30-0.9.30/bin 


i) make menuconfig // To configure bootloader settings 
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Main Menu 


Arrow keys navigate the menu. <Enter> selects submenus --->. 


letters are hotkeys. 
features. 


{ ] excluded <M> module 


Highlighted 


Pressing <Y> includes, <N> excludes, <M> modularizes 
Press <Esc><Esc> to exit, <?> for Help. 


< > module capable 


Legend: [*] built-in 


ii) Choose ‘<Exit>’ and click ‘Enter’ 
Note: 


Above we just use default configure file for bootloader settings. 
If we want to configure bootloader different from default configure file, 


select ‘Target Platform Selection’ and click ‘Enter’ to customize settings of bootloader. 


Do you wish to save your new kernel configuration? 


iii) Choose ‘<Yes>’ and click ‘Enter’ 
Step 4, compile bootloader. 


make 


2.3. Compile rlxlinux 
Steps to compile applications and linux are as follows: 
Step 1, enter rtl819x directory. 
Step 2, configure rlxlinux. 
i) make menuconfig // To configure rlxlinux settings 


ii) Do some settings as follows: 


‘Selected Target’ to choose rtl8196c, rtl8196ct, rtl8198, 
rtl8198t, rtl8954C,rtl8 19xD,rtl8 198c and rtl8197f supported at present; 
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‘Selected Kernel’ to choose linux kernel; 

‘Selected Busybox’ to choose busybox; 

‘Selected toolchain’ to choose toolchain to compile rlxlinux; 
‘Selected Board Configuration’ to choose flash type (NOR or SPI) 
and squash file system. 


Example I, settings for RTL8196C demo board as follows: 


RLX Linux Configuration 


Cl Load default settings 
g 
Ss. 


Li 
Si 


KSelect>} 


Example II, settings for RTL8198 demo board as follows: 
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[h Load default settings 


<Select> 


Example III, settings for RTL8954C demo board as follows: 


Example IV, settings for RTL8196CS demo board (iNIC) as follows: 
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RLZX Linux Configuration 


components 


5 
c 
iS 


ne 


|b 


m 


Example V, setting for RTL8196D demo board as follows: 
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RLX Linux Configuration 


Cc 
Cc 
Cc 


[9] Load default settings 


s 


L 
Ss. 


KSelect> 


Example VI, setting for RTL8197D demo board as follows: 
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[w] Load default settings 


<Select> 


Example VII, setting for RTL8196CT demo board as follows: 
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Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
built-in [ ] excluded <M> module < > module capable 


Cl 


--- select components 
elected Target (rtl1é8196ct) 
elected Kernel (linux-2.6.30) =---> 
elected Busybox {(busybox-1.13) ---> 


---> 


elected toolchain 

ae je eillsjaleverere 

elected Target of SDK 

elected Board Configuration 

- config components 

] Config kernel 

] Config users 
] Config 


refexe ls lG Sip ae ea Ma laly UG ele eM) ee 


(llnRouter_ GW) ---> 


(SPI flash + Squashfs) ---> 


ave default settings 


oad an Alternate Configuration File 
ave an Alternate Configuration File 


a < > << 


Example VUI, setting for RTL8198T demo board as follows: 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
built-in [ ] excluded <M> module < > module capable 


[2] 


--- select components 
elected Target (rt16196t) ---> 
elected Kernel (linux-2.6.30) ---> 
elected Busybox (busybox-1.13) ---> 
elected toolchain (rsdk-1.3.6-5281-EB-2.6.30-0.9.30) 

=== Ghee 
elected Board Configuration (SPI flash + Squashfs) 

--- config components 

[ ] Config kernel 

[ ] Config users 

i iecontaug 


---> 


---> 


ave default settings 


oad an Alternate Configuration File 
ave an Alternate Configuration File 
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Example IX, setting for RTL8196E demo board as follows: 


RLX Linux Configuration 


Ss 


Cc 
Cc 
Cc 


[i] Load default settings 
Ss. 


Li 
Ss. 


KSelect> 


Example X, setting for SDK 11.0 demo board as follows: 
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RLX Linux Configuration 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


--- select components 


Selected Target (rtl89xxD) ---> 

Selected Kernel (linux-2.6.30) ---> 

Selected Busybox (busybox-1..13) -—==> 

Selected toolchain (rsdk-1.5.5-5281-EB-2.6.30-0.9.30.3-110714) ---> 
Se TeEMey S40) 


Selected Board Configuration (V100 Squashfs + VE890HV 2S + 92C + SAMBA) --- 


--- config components 

{ ] Config kernel (NEW) 

{ ] Config users (NEW) 

{ ] Config busybox (NEW) 
[*] Load default settings 
{ ] Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


< Exit > < Help > 


Please select one of the following Board Configuration according to your board. 


Selected Board Configuration 
Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
<?> for additional information about this option. 


v100_ Squashfs + NG V¥YorP + S2c 

v100 Squashfs + VESS0HV_2S510 + 92C 

v100 Squashfs + VESS0HV_2S510 + 92D 

v100 Squashfs + VE890HV 2510 + 92C + SAMBA 


100 Squashfs + VE890HV 2S + 92C + SAMBA 


) vl00_ Squashfs + VE880 2S + 92C + SAMBA 


< Help > 


Example XI, setting for RTL8197D+8192C+8812AE +8367RB demo board as follows: 


©2011 Realtek Semiconductor Corp. 12 


[hi] Load default settings 


<Sselect> 


Example XII, setting for RTL8197D+88 12AE+8367RB+92ER demo board as follows: 


| Selected Board Configuration (97D+8367R+92E+8812 GW) ---> 


<Select> 
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Example XIII, setting for RTL8881A+88ER demo board as follows: 


oad default settings 
s. 


L 
s. 


Example XIV, setting for RTL8881A+92ER demo board as follows: 
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[i Load default settings 


<Select> 


Example XV, setting for RTL8192E+8192E 2M/16M demo board as follows: 
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Example XVI, setting for RTL8881A Selectable demo board as follows: 


default settings 


Example XVII, setting for RTL8198C+8812AE+92ER demo board as follows: 


a Selected Board Configuration (RTL8198C/8954E+8812+92E GW) ---> 


<Select> 
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Example XVII, setting for RTL8198CD+8812AE+92ER demo board as follows: 


| Selected Board Configuration (RTL8198CD/8954E+8812+92E GW) -<<> 


<Select> 


Example XIX, setting for RTL8198CS+8812AE+92ER demo board as follows: 


| Selected Board Configuration (RTL8198CS/8954ES+8812+92E GW) -=--> 


<Select> 
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Example XX, setting for RTL8197F+8812AE demo board as follows 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded <M> module 
< > module capable 


--- select components 


Selected Target (rt18197F) ---> 

Selected Kernel (linux-3.10) ---> 

Selected Busybox (busybox-1.13) ---> 

Selected toolchain (msdk-4.4.7-mips-EL-3.10-u0.9.33-m32t-140827) ---> 
== Pelelorh 

Selected Board Configuration (RTL8197F/8812 GW) ---> 


- config components 
] Config kernel 

] Config users 

] Config busybox 

] 

] 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


Qiels < Help > 


iii) Select “Load default settings’, then choose ‘<Exit>’ and click ‘Enter’ 
Note: 


Above we just use configure applications and linux kernel in default way. 
If we want to customize linux kernel, we can select ‘Config kernel’; 

if we want to customize applications, we can select ‘Config users’; 

if we want to customize busybox, we can select ‘Config busybox’; 


then choose ‘<Exit>’ and click ‘Enter’. 


Do you wish to save your new configuration? <ESC><ESC> 
to continue. 


iv) Choose ‘<Yes>’ and click ‘Enter’ 


Step 3: compile rlxlinux. 


Make 


2.4. Compile rlxlinux detailed 


2.4.1 Compile rlxlinux process 


Compile rlxlinux include several steps as follows. 

(1) Compile user dir (rtl819x/users); 

(2) Compile board dir (rtl819x/boards/*::**: ) and compile user dir (rtl819x/users) romfs; 
(3) Compile linux dir (1tl819x/inux-2.6.30 or rtl8 19x/linux-3.10) module; 

(4) Compile linux dir (rtl819x/inux-2.6.30 or rtl8 19x/linux-3.10); 
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(5) Create image dir (rtl819x/image) and compile board dir(rtl8 19x/boards/*::**- ) image. 


2.4.2 Images generated 
After compile rlxlinux, several images are generated at image dir (rtl819x/image). 


(1) Full image include webpages, root file system and linux kernel, which can be uploaded via 
webpage or tftp. 


fw.bin 

(2) Image includes webpages only, which can be uploaded via webpage or tftp. 
webpages-gw.bin 

(3) Image include root file system only, which can be uploaded via webpage or tftp. 
root.bin 

(4) Image include linux kernel only, which can be uploaded via webpage or tftp. 
linux.bin 

(5) Configure file of default settings, which can be uploaded via webpage. 
config-gw-*.dat 


2.4.3 Tools to make images 
To make images, tools such as cvcfg-gw, compweb, cvimg, mgbin are stored at 
rtl819x/users/goahead-2.1.1/LINUX or rtl819x/users/boa/tools if Boa web server is selected. 


More info about these tools, please refer to Chapter 5 FLASH tools. 


©2011 Realtek Semiconductor Corp. 


3. AP-Router SDK images upload 


3.1 Topology to upload image 


Topology to upload image is as follows: 


Connect AP’s LAN port with PC to transmit data and connect AP’s UART port with PC’s serial 
port to send command. 


’ Console v 
L_| ‘ 


=~ Ethernet A 


3.2 Upload bootloader image 


Via 2.1 bootloader compilation, bootloader image is generated at bootcode_ rtl8196c_98 
(bootcode_rtl819xD or bootcode_rtl8198c)/btcode/ which is boot. bin. 


Steps to upload bootloader image are as follows: 


Step 1, reboot AP and click ‘Esc’ via console during AP booting, then AP enter bootloader 
environment. Output of AP’s console is as follows: 


-16:14+0800 version vl.la 


[16bit] (390MHz) 


Step 2, upload bootloader image via AP’s lan port using tftpd. Settings of tftp are as follows: 
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Tftpd32 by Ph. Jounin 


Current DirectorpfJ-4\lx96c_100406\RLXLinux\bootcode\bte Browse 
Server interface |172.29.34.24 | Show Dir 


Tftp Server Tftp Client Syslog server | 


Host} |192.168.1.6 
File boot. bin 


Get | _Put | Bieck| 


= 


About Settings Help 


Step 3, click ‘Put’ at tftp UL. 


3.3. Upload rlxlinux image 
Via 2.2 rlxlinux compilation, images are generated at rtl819x/image/ which are webpages-gw.bin, 
root.bin, linux.bin or fw.bin (which include webpages-gw.bin, root.bin, linux.bin). To upload rlxlinux 


images, we need to upload fw.bin or webpages-gw.bin, root.bin, linux.bin three images. 
Steps to upload rlxlinux images are as follows: 


Step 1, reboot AP and click ‘Esc’ via console during AP booting, then AP enter bootloader 


environment. Wait few seconds for Ethernet initialization. Output of AP’s console is as follows: 


---Ethernet init 
<RealTek> 


Step 2, upload rlxlinux images via AP’s lan port using tftpd. Settings of tftp to upload 


webpages-gw.bin are as follows. 


And settings of tftp to upload root.bin, linux.bin or fw.bin are the similar, just use root.bin, 


linux.bin or fw.bin as ‘File’ input at tftp UI instead. 
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Tfitpd32 by Ph. Jounin SEE 


Current Directory -\le96c_100406\RLXLinux\rlslinus-v2. 24 Browse 
Server interface | 472293424 ¥ Show Dir 


Tftp Server Tftp Client Syslog server | 


Host ||192.168.1.6 
File |[Webpagesgwbirl 


x 


About Settings Help 


Step 3, click ‘Put’ at tftp UI. 


After fw.bin or webpages-gw.bin, root.bin and linux.bin are uploaded, AP boots up, and input IP 
(get it via console “ifconfig”, default 192.168.1.254) at the browser, the webpage will appear. 


é Realtek WLAN AP Webserver —- Windows Internet Explorer 


Ge 


® abe @ikealtek WLAN AP Webserver 


’ é) http: //192. 168. 1.254/home. asp 


A REALTEK WLAN Access Point 


PREPRPRPHEER. 


ite contents: Setup Wizard 
Setup Wizard 


Operation Mode 
Wireless 
TCP/IP Settings 
Firewall 

QoS 


time. Please follow the setup wizard step by step. 


Velcome to Setup Wizard. 


Management by clicking on Next. 


Setup Operation Mode 
Choose your Time Zone 
Setup LAN Interface 

Setup WAN Time Zone 
Select Wireless Band 
Wireless LAN Setting 
Wireless Security Setting 


& Internet 
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man > cb WH) ~ 


The setup wizard will guide you to configure access point for first 


Route Setup The Wizard will guide you the through following steps. 


FIA ©) - 


Begin 
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3.4 Upload default setting data (Optional) 


Via 2.2 rlxlinux compilation, default setting data are generated at rtl8 19x/image/, named like 
config-gw-98-92c-92d.dat. 


To upload default setting data, open AP webpage, select Management->Save/Reload Settings, 
browse and select config data file(ex: config-gw-98-92c-92d.dat) then upload. 


/- Realtek WLAN AP Webserver — Windows Internet Explorer 


é) ic v ‘é) http: //192. 168. 1.254/home. asp 


® ake @ kealtek WLAN AP Webserver 


A UREALTEK: WLAN Access Point 


Site contents: Save/Reload Settings 
B Setup Wizard 


a Operation Mode This page allows you save current settings to a file or reload the 
Mi Wireless settings from the file which was saved previously. Besides, you could 
f TCP/IP Settings reset the current configuration to factory default. 
Gi Firewall 
B QoS 


. Save Settings to 
B Route Setup File: 
an 
— 1 - 
BH Status road Settangs from (7:\rlxlinux—v2. 2\inage\co( BIR... _) [Upload 


Statistics F 
Reset Settings to 
DDNS Default: 
Time Zone Setting 
Denial-of-Service 


= 
a 
a] 
a 
& Log 
a 
2 
a 


Upgrade Firmware 
Save/Reload Setting 
Password 


100% + 


After upload complete, AP will reboot. 


3.5 Upload rlxlinux image via webpage (Optional) 


Open AP webpage, select Management-> Upgrade Firmware browse and select image file (ex: 
rtl819x/image/fw.bin), then upload. 
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/- Realtek WLAN AP Webserver — Windows Internet Explorer 


é) c ’ é) http: //192. 168. 1. 254/home. asp?t=1303890241531 


w ake @ Realtek WLAN AP Webserver 


WLAN Access Point 


Upgrade Firmware 


This page allows you upgrade the Access Point firmware to new version. 
Please note, do not power off the device during the upload because it 
may crash the system. 


Firmware Version: v2.5 


Select File: (Z: \rlxlinux-v2. 2\imag (I...) 
Statistics 


DDNS 

Time Zone Setting 
Denial-of-Service 
Log 

Upgrade Firmware 
Save/Reload Setting 
Password 


After upload complete, AP will reboot. 


3.6 Upload rlxlinux image with config file via webpage (Optional) 


You can upload rlxlinux image with configuration file at one time via webpage by following step. 
a. Copy the tool “mgbin” to “rlxlinux-v2.2/image”’ first. 


b. Combine rlxlinux image and configuration file by “./mgbin -c -o 
all_fw.bin /root.bin ./webpages.bin ./config-gw-xxx-xxx.dat ./linux.bin” 


c. The all_fw.bin is the rlxlinux image with configuration file. 


d. Upload the all_fw.bin via webpage like below. 
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/- Realtek WLAN AP Webserver — Windows Internet Explorer 


é) CY é) http: //192. 168. 1. 254/home. asp?t=1303890241531 


w ake @ Realtek WLAN AP Webserver 


WLAN Access Point 


: 


ite contents: Upgrade Firmware 
etup Wizard 


S 

Operation Mode This page allows you upgrade the Access Point firmware to new version. 
Wireless Please note, do not power off the device during the upload because it 
TCP/IP Settings may crash the system. 


Firewall 
QoS 
Route Setup 


Firmware Version: v2.5 


Select File: iZ:\rlxlinux-v2. 2\imag (I...) 


S 
a 
a 
Ld 
- 
. 
a 
& 


Status 

a 
yh 

Time Zone Setting 

Denial-of-Service 

Log 

Upgrade Firmware 

Save/Reload Setting 

Password 


& Internet 
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4. Features configure 

The following SDK block diagram describes most of SDK software features. The green block 
indicates that the feature is enabled on the router default configuration of most of platforms. The 
orange block indicates that the feature is disabled on the router default configuration or not supported 
on some platforms. Users can enable or disable these features by using “make menuconfig “ and the 


related procedures are described in the subsection below. 


wireless tools Applications IPv6 Ready ppp | pptp I2tp 
Logo 


1in/tiac WiFi > BT Crypto Engine SquashFS 
driver driver driver driver 
PCle Host SPI driver Linux 3.10 L3 Routing/L4 Napt SPI NOR 
Flash driver 
Parallel NAND SPI NAND eMMC/SD driver Bridge Fast Path GPIO driver 
Flash driver Flash driver 
USB EHCI USB OTG Watchdog driver Switch driver UART driver 
driver driver 


4.1 PCI support 


4.1.1 Linux kernel PCI not support 
By kernel default settings, linux kernel PCI is not supported, because wireless driver use its own 


PCI driver. Linux kernel configure as follows. 
make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 
Bus options (PCI/USB) ---> 


Support for PCI controller —_// Not selected 
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Bus options (PCI/USB) 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 


<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


upport for PCI controller 
bcCard (PCMCIA/CardBus) support ---> 


4.1.2 Linux kernel PCI support 


If wireless driver use the PCI BIOS driver of linux kernel, linux kernel configure as follows. 


make linux_menuconfig // To configure linux kernel settings 


Menuconfig: 
Bus options (PCI/USB) ---> 
Support for PCI controller // Selected 


Enable deprecated pci find * API(NEW) _// Selected 
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Bus options (PCI/USB) 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 


<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


upport for PC a5 

Enable deprecated pci find * API (NEW) 
PCI Stub driver (NEW) 

PCI IOV support (NEW) 
Support for PCI Hotplug (NEW) 
PcCard (PCMCIA/CardBus) support 


4.2 USB support 
(1) Enable USB controller (Only RTL8197F is needed) 


make linux_menuconfig 
Menuconfig: 
Machine selection ---> 
BSP configuration ---> 
[*] Enable USB controller 


BSP configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


Timer Source (Use MIPS internal counter) ---> 


Enable PCI controller 
wi] Enable USB controller 


<, EXle > < Help > < Save > < Load > 


(2) If USB is not supported, linux kernel configure for USB as follows. 


make linux_menuconfig // To configure linux kernel settings 
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Menuconfig: 
Device Drivers ---> 
USB support ---> 
[*] | EHCI support 


<*> Support for Host-side USB 


USB support 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


--- USB support 
[ ] OHCI support (NEW) 
[*] EHCI support 
XHCI support (NEW 
due peice upport for Host-side USB 
USB verbose debug messages (NEW) 


USB announce new devices (NEW) 
*** Miscellaneous USB options *** 


[*] Enable USB persist by default (NEW) 
C ] Dynamic USB minor allocation (NEW) 
(+) 


< Exit > < Help > < Save > < Load > 


(3) If USB is supported, linux kernel configure for USB as follows (Except of RTL8196E/ 
RTL8198C). 


make linux_menuconfig // To configure linux kernel settings 


Menuconfig: 


Device Drivers ---> 
USB support ---> 


Support for Host-side USB __// selected 
EHCI HCD (USB 2.0) support —_// To support USB 2.0, if selected 
OHCI HCD support // To support USB 1.1, if selected 
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USB support | 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


USB verbose debug messages 
USB announce new devices 
**x* Miscellaneous USB options *** 


USB device class-devices (DEPRECATED) 
Dynamic USB minor allocation 

Rely on OTG Targeted Peripherals List 
Disable external hubs 


Enable Wireless USB extensions (EXPERIMENTAL) 
Support WUSB Cable Based Association (CBA) 


**% USB Host Controller Drivers *** 


Cypress C67x00 HCD support 
EHCI HCD (USB 2.0) support 
Root Hub Transaction Translators 
Improved Transaction Translator scheduling (EXPERIMENTAL) 
OXU210HP HCD support 
ISP116X HCD support 
ISP 1760 HCD support 
OHCI HCD support 
SL811HS HCD support 
R8A66597 HCD support] 


(4) If OTG USB is supported, linux kernel configure for OTG USB as follows in the (RTL8196E, 
RTL8197D/ RTL8881A/ RTL8197F). 


make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 


Device Drivers ---> 
USB support ---> 


Support for Host-side USB = _// selected 


Synopsys DWC_OTG support 
enable debug mode 
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if jasonwang@localhost:/home/jasonwang/0312/RLZLinux/rlxlinux-v2.2 [94x34] 
BRC) iRGE) RR) MeO) BRO) Ba) 


USB support 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters 
are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] 
excluded <M> module < > module capable 
L-) 

USB LED driver support 

Cypress CY7C63xxx USB driver support 

Cypress USB thermometer driver support 

Sienens ID USB Mouse Fingerprint sensor support 

Elan PCMCIA CardBus Adapter USB Client 

Apple Cinena Display support 

USB LD driver 

PlayStation 2 Trance Vibrator driver support 

10 Warrior driver support 

iSight firmware loading support 

USB ¥ST driver 

Realtek RTS5139 USB card reader support 

USB Gadget Support ---> 

*** OTG and related infrastructure *** 

NOP USB Transceiver Driver 

Synopsys DWC_OTG support 


ena de 
HOST ONLY MODE (NEW) 
DEVICE ONLY MODE (NEW) 
Enable Realtek usb auto_det control circuit 


< Exit > < Help > 


(4) If xHCI USB is supported, linux kernel configure for xHCI USB as follows in the 
(RTL8198C). 


make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 


Device Drivers ---> 
USB support ---> 


XHCI support 
Support for Host-side USB _—_// selected 
xHCI HCD (USB 3.0) support 
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USB support 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> 
to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded <M> module 
< > module capable 


--- USB support 
Ea OHCI support 
Ps EHCI support 
[*] XHCI support 
[*] Support for Host-side USB 
| ee | USB verbose debug messages 
Ey USB announce new devices 
*** Miscellaneous USB options *** 
Enable USB persist by default 
Dynamic USB minor allocation 
Rely on OTG Targeted Peripherals List 
Disable external hubs 
USB Monitor 
Support WUSB Cable Based Association (CBA) 
*** USB Host Controller Drivers *** 
Cypress C67x@@ HCD support 
»xHCI HCD (USB 3.@) support 
Support for XHCI USB controller on platform 
Debugging for the xHCI host controller 
OXU21@HP HCD support 
TSP116X HCD support 
ISP 176@ HCD support 


* 


Ex 
Eee 
Bes 
Ea 
C] 
{] 


Kee SS SSeS ee 
* # 
ne ee 


=~ 


< Exit > < Help > < Save > < Load > 


4.3 Samba support 
4.3.1 Samba kernel configure 
4.3.1.1 SCSI support 
Linux kernel configure for SCSI as follows. 
make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
SCSI device support ---> 
SCSI device support // selected 
SCSI disk support // selected 
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SCSI device support 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. 
<Esc><Esc> to exit, <?> for Help, </> for Search. 
<M> module < > module capable 


Legend: [*] built-in 


RAID Transport Class 
[*] SCSI device support 
{ ] $CSI target support 
[*] legacy /proc/scsi/ support 
*** SCSI support type (disk, tape, CD-ROM) *** 

support 


scsi 


SCSI OnStream SC-x0 tape support 


SCSI generic support 
SCSI media changer support 
*** Some SCSI devices (e.g. CD jukebox) 
] Probe all LUNs on each SCSI device 
] Verbose SCSI error reporting (kernel size +=12K) 
] SCSI logging facilit 
] 
+ 


] 
] 
] 
] SCSI CDROM support] 
] 
] 


Asynchronous SCSI scanning 


4.3.1.2 File systems 
Linux kernel configure for file systems as follows. 
make linux_menuconfig // To configure linux kernel settings 
Menuconfig (1): 
File systems ---> 
Enable POSIX file locking API —_// selected 


XFS filesystem support 
OCFS2 file system support 


nable POSIX file locking API 


[ 
[ 
[ 
[ 
[ 
[ 


Inotify file change notification support 


Menuconfig (2): 
File systems ---> 
DOS/FAT/NT Filesystems ---> 
<*> MSDOS fs support 
<*> VFAT (Windows-95) fs support 
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support multiple LUNs *** 


Press 
{ ] excluded 


] 
] 
] Btrfs filesystem (EXPERIMENTAL) Unstable disk format 
] 
] 
] 


33 


DOS/FAT/NT Filesystems 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


<*> MSDOS fs support 

<> VFAT (Windows-95) fs support 
(437) Default codepage for FAT 
(iso8859-1) Default iocharset for FAT 
< > exFAT fs support 

< > NIFS file system support 


< Exit > < Help > < Save > < Load > 


Menuconfig (3): 


File systems ---> 
Native Language Support ---> 
Codepage 437 (United States, Canada) //Selected 
NLS ISO 8859-1 (Latin 1; Western European Languages) // Selected 
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[*] Base native language support 
{iso08859-1) Default NLS Option (NEW) 

[ee] Codepage 437 (United States, Canada} 
] Codepage 737 (Greek) (NEW) 
] Codepage 775 (Baltic Rim) (NEW) 

] Codepage 850 (Europe) (NEW) 
] Codepage 852 (Central/Eastern Europe) (NEW) 
] Codepage 855 (Cyrillic) (NEW) 

] Codepage 857 (Turkish) (NEW) 

] Codepage 860 (Portuguese) (NEW) 

] Codepage 861 (Icelandic) (NEW) 

] Codepage 862 (Hebrew) (NEW) 
] Codepage 863 (Canadian French) 

] Codepage 864 {Arabic} (NEW) 

] Codepage 865 (Norwegian, Danish) {NEW} 
] Codepage 866 (Cyrillic/Russian) (NEW) 
] 

] 

] 

] 

] 

] 

] 

] 

] 

] 

] 

] 

] 


(NEW) 


Codepage 869 (Greek) (NEW) 
Simplified Chinese charset (CP936, GB2312) (NEW) 
Traditional Chinese charset (Big5) (NEW) 
Japanese charsets (Shift-JIS, EUC-JP} (NEW) 
Korean charset (CP949, EUC-KR) (NEW) 

Thai charset (CP874, TIS-620) (NEW) 
Hebrew charsets (IS0-8859-8, CP1255}) (NEW) 
Windows CP1250 (Slavic/Central European Languages) (NEW) 
Windows CP1251 (Bulgarian, (NEW) 
ASCII (United States) (NEW) 
Hie: 130 saog— 0 {Latin 1; Western European Languages) 
NLS ISO 8859-2 (Latin 2; Slavic/Central European Languages) (NEW) 
NLS ISO 8859-3 (Latin 3; Esperanto, Galician, Maltese, Turkish) (NEW) 


Belarusian) 


See Dime) | ——" [eee pe Be I ce re Pe ee ee ee ee ee 


4.3.1.3 USB Mass Storage support 
Please refer section 4.2 to enable USB Support first. 


make linux_menuconfig 
Menuconfig: 
Device Drivers ---> 
[*] USB support — ---> 
<*> Support for Host-side USB 


<*> USB Mass Storage support 


©2011 Realtek Semiconductor Corp. 35 


USB support 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


(-) 

. USB Wireless Device Management support 

<> USB Test and Measurement Class support 
*** NOTE: USB STORAGE depends on SCSI but BLK_DEV_SD may 
*** also be needed; see USB_STORAGE Help for more info ** 

<> USB Mass Storage support 

[ ] USB Mass Storage verbose debug 

<> Realtek Card Reader support 

<> Datafab Compact Flash Reader support 

<> Freecom USB/ATAPI Bridge support 

<> ISD-200 USB/ATA Bridge support 

1(+) 


< Extt > < Help > < Save > < Load > 


4.3.1.4 General setup (Kernel-2.6.30 only) 
make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 
General setup ---> 
--- Configure standard kernel features (for small systems) ---> 


Support for hot-pluggable devices // selected 


[*] Optimize for size 
Configure standard kernel 
Strip assembler-generated 
[ ial] upport for hot-pluggable 

[*] Enable support for printk 
[ 1] Enable support for printk 


features (for small systems) ---> 


rebel eye me Gla rye 


4.3.1.5 System configure 
make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 
Machine selection  ---> // RTL8197F only 
System Configuration ---> 


[*] Seedup usb samba performance 
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System Configuration 

Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


System Type (RTL8198 Demo Board) ---> 
*] Enable watchdog timer support 


***x Flash size 2M or 4M, default 2M *** 
(0x400000) Size of Flash 
*** Hardware setting offset,should be 4K alignment *** 
(Ox6000) Hardware setting offset in flash. 
***x Default setting offset,should be 4K alignment. *** 
*** size of default and current setting should be same. 
(0x8000) Default setting offset in flash. 
*** Current setting offset,should be 4K alignment. *** 
(OxcO00) Current setting offset in flash. 


v(+) 


4.3.2 Samba application configure 


4.3.2.1 enable usbmount 


make users_menuconfig // To configure application settings 
Menuconfig: 
usbmount // selected 
{ ] ulinker autorun image tool 
[ ] Updatedd DDNS 
[2] usbmoun 
[i usbdisk update image (NEW) 
[ ] uUWiFi 
[ ] vsttpd 
{ ] Wireless tools 
{ ] wsc daemon 
Libraries Settings ---> 
Debug & Test Settings ---> 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


4.3.2.2 enable samba 
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make users_menuconfig // To configure application settings 


Menuconfig: 


[*] samba support ---> // selected 


--- samba support 


samba version (samba-3.0.24)  ---> 


<Select> 
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RLX Linux Configuration 


5 
S 
S 


it teat hese UD 


il Selected toolchain (rsdk- 1. 5. 5-5281-EB-2. 6. 30-0. 9. 30.3-110714) -——| 


C 
C 
ly 


KSelect)| 


4.3.3 Samba Enable on board 
To enable Samba on board, the mib SAMBA ENABLED must be set 1(default 0). 
Two ways to set the mib. 
a) via Console: 
# flash all| grep SAMBA 
DEF_SAMBA_ENABLED=0 
SAMBA_ENABLED=0 
# flash set DEF_SAMBA_ENABLED 1 
# flash set SAMBA_ENABLED 1 
# flash all| grep SAMBA 
DEF_SAMBA_ENABLED=1 
SAMBA_ENABLED=1 
b) via webpage 
(1)Edit users/boa/defconfig/config-gw-xx.txt (use boa) or users/goahead-2.1.1/LINUX/ 
config-gw-xx.txt (use goahead) to set DEF_SAMBA_ENABLED and SAMBA_ENABLED 1 
(2)Build the image, and find the config.dat file in image/config-gw-xx.dat 
(3)Upload the config.dat file via webpage Management Save/Load Settings 
(4)After rebooting the mib will be set. Use flash all| grep SAMBA to check 
4.3.4Test Samba using USB flash disk 
After system boots up, plug-in an USB Flash disk, you can read/write the USB flash in /tmp/usb 
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directory. 
4.3.5 How to add Samba user 
After system boots up, start to add Samba user (testuser) as follows: 
#echo "testuser:x:0:0:testuser:/:/dev/null" >> /var/passwd 
#echo "[testuser] 
comment = testuser's stuff 
path = /var/log 
valid users = testuser 
public = no 
writable = no 
printable = no 
create mask = 0765" > /var/smbuser.conf 


# smbpasswd -a testuser 


New SMB password: // input new SMB password here 
Retype new SMB password: // re-input new SMB password here 
Added user testuser. 

# killall smbd 

# smbd —D 


Note: at present, only rtl8198 and rtl8954C SDK support this feature. 
4.3.6 Factors related to test performance 
There are several factors that have effect on the performance of samba test; the related factors are as 
follows: 
(1) When we test, enable the config: RTL_USB_IP_HOST_SPEEDUP in kernel config, the 
performance will be improved about 20%; 
(2) The usb disk used for test. Sata disk will improve the performance about 10%-20% compared with 
the ordinary USB flash disk; 
(3) The test card. New card will have better performance, 98-v631 can improve 15% compared with 
98-v630; 
(4) The test computer. Different computer may result in different test performance; 
(5) The test software. CrystalDiskMark and fastcopy could have different performance as much as 
10%.If choose CrystalDiskMark for test, the cycle number and disk size are related too, we choose 
5/50M, which is better than just once. 
(6) Toolchain. The given test result is based on rsdk-1.3.6. The samba size will be smaller on 
rsdk-1.5.5, and the performance will be better. 


4.3.7 How to enable ntfs file system for samba 
4.3.7.1 Linux kernel configures for ntfs file systems as follows. 


make linux_menuconfig // To configure linux kernel settings 
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Menuconfig: 
File systems ---> 


FUSE (Filesystem in Userspace) support __// selected 


File systems 


Ss 
E 
ui} 
J 
x 
0 
B 
E 
D 
L 
Q 
K 
K 


] FUSE (Filesystem in Userspace) support} 


a 


L-~e) 


o > 


K<Select>| 


4.3.7.2 users configure for ntfs file systems as follows. 


make users_menuconfig // To configure application settings 
Menuconfig: 


ntfs3g —_ // selected 


RLX Linux Configuration 


ile system Configuration ---> 
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4.4 USB 3G/4G support 

4.4.0 Brief Concept 

@ 4G/LTE will be automatic available if you enable the USB 3G support. 

@) The following procedure is only for 3G support instead of 4G LTE function. 

@) If you only wants to support 4G/LTE function, please check 4.4.8 4G LTE support. 
4.4.1 Basic software flow 

() Get the hotplug event. 

@) Find the right config for usb_modeswitch. 

(8) Monitor and control the activity of eject storage usb. 

@) Prepare /var/usb3.option and /var/usb3g.chat and call pppd-chat. 

©) If eject fail or call pppd fail, execute hub_ctrl to disconnect usb device, then run from beginning. 


User space 


Ps. 

mnet: a utility to control the above flow. 

usb_modeswitch: a mode switching tool for controlling multiple device USB (turn from storage 
mode into modem mode). 
4.4.2 Linux kernel configure 

In System Configuration, please select USB3G support and change the size of Flash to 0x400000, 


©2011 Realtek Semiconductor Corp. 42 


and linux image offset to 0x130000 (make sure your board is 32M/4M sdram/flash, and bootloader is 


also compatible). 


Ss 
E 
E 
W 
SI 
E 
Pi 
D 


[1] USB3G support 


The usbfs filesystem for USB devices is traditionally mounted at /proc/bus/usb. It provides the 
/proc/bus/usb/devices file, as well as the /proc/bus/usb/BBB/DDD files. In linux-3.10 the usbfs 
filesystem isn't used at all. Instead USB device nodes are created under /dev/usb/ or someplace similar. 
The "devices" file is available in debugfs, typically as /sys/kernel/debug/usb/devices. 

Please select Debug Filesystem to support debugfs. 

make linux_menuconfig 

Kernel hacking ---> 
[*] Debug Filesystem 
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mount debugfs when init system: 
mount -t sysfs none /sys 
mount -t debugfs none_debugs /sys/kernel/debug 
4.4.3 User configure 
1) User space programs 


b 
u 
u 

ul 

e 


2) Busybox command 


| i eel oo | 


Linux System Utilities ---> 


4.4.4 Add new USB 3G dongle support 
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4.4.4.1 Modify mnet 

While usb dongle has been inserted and attached as modem device, kernel appear several 
tty USB* in the /dev folder. The name of ttyUSB will append a number, for example: ttyUSBO. But the 
number doesn't always start from 0, mnet will find a proper one, and generate a ppp option file in the 


path /var/usb3g.option. Below is an example entry. In the most case, you doesn't need to change it. 


a at 
cept -remote 


ABORT ‘COMMAND NOT SUPPORT' 


' 
'ATZ' 


‘show device infomation... 
ATI! 


‘show SIM CIMI...\n' 
"AT+CIMI' 


‘set APN...\n' 
'AT+CGDCONT=1, "IP", "internet"' 


SAY ‘dial...\n\n' 
‘OK' "ATD*OS#' 
"CONNECT ' 


Fig. Example of ppp chat 
In some cases, for example: the dongle has special AT command, you may need to change the 
function void gen_ppp_option (char *ttyitf) to generate /var/usb3 g.option and /var/usb3¢.chat for it. 
4.4.4.2 Add new usb_modeswitch config file 
Generally, mnet will detect the usb dongles’ type and find a matched config for usb_modeswitch 
when inserted (i.e. hotplug occurred). 
If an unsupported dongle is found, you can type command “lsusb” under the console to 


identify the vendor id and product id, and get the support from 
http://www.draisberghof.de/usb_modeswitch/#download. 
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cannot open “/etc/usb.ids", No such file or directory 
901 Device O01: ID 1d6b:0002 


1 
Bu 
HI 


Fig. find matched usb_modeswitch config 
4.4.4.3 Modify option.c 

If there is no supported config file, you need manually to add the vendor id and product id into 
linux-2.6.30/drivers/usb/serial/option.c (or linux-3.10/drivers/usb/serial/option.c) and also implement a 
suitable eject utility (ex: usb_modeswitch we used, it's kind of eject utility) for this dongle. 
4.4.4.4 Add custom eject function 

If there is a dongle doesn't support by usb_modeswitch, you can hook it into the follow of 
original usb_modeswitch, by add your own eject function in the structure, and add corresponding 
config. 

struct custom_mode_db_ s{ 
int idx; 


char *modeName; 
void (*switch_func) (void); 


enum { 
QISDA_MODE = 1, 
MBPK_MODE = 2, 
}; 
struct custom_mode_db_s custom_mode db[] = f 
{ QISDA_MODE, “qisda", switchQisdaMode hi 
{ MBPK_MODE, "mobilepeak", | ejectMobilepeakCDROM  }, 
ti 


PREAAEAEAARASRAAEAARSA SAAR REBAR RARER RRR EERE EEE EE 
# newer modems 


DefaultVendor= Oxlda5S 
DefaultProduct=0xf000 


TargetVendor= Oxlda5 
TargetProduct= 0x4512 


CustomMode="qisda" 
CheckSuccess=20 


4.4.5 USB 3G/4G Connection 
4.4.5.1 Manual connect/disconnect 

If you are not using unlimited data plan, you can use manual dial. Please open the management 
web page [TCP/IP Setting] > [WAN Interface], and change “connection type” to “Manual” then 


reboot, after that you can connect or disconnect on your will. 
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WLAN Access Point 


WAN Interface Setup 


This page is used to configure the parameters for Internet network which cc 
Here you may change the access method to static IP, DHCP, PPPoE, PPTP 
Access type. 


| Interface 
VAN Interface 


WAN Access Type: USB3G S 


User Name: 
Password: 
PIN: 

APN: 

Dial Number: *99# 


internet 

GF Connect 
(1-1000 minutes) 
(1360-1492 bytes) 


Connection Type: Manual 
Idle Time: 5 


MTU Size: 1452 


Disconnect 
de Firmware 
Ss : 


Ss 


4.4.5.2 Connection status 
If you want to know the running status of the mnet, you can get it via management web page 
[Management] > [Status], looking for the field “Attain IP Protocol” under the “WAN Configuration”. 
We provide 5 statuses as follows: 
(@) B3G Removed: there is no usb dongle on the DUT. 
(2) 3G Modem Initializing...: the usb dongle has been inserted, and mnet is starting eject 
process. 
(8) 3G Dialing...: ejected and attached as modem device. Trying to establish a PPP 
connection. 
(4) 3G Connected: PPP connection has been established. 
©) 3G Disconnected: PPP connection hangs up. 
WLAN Access Point 
Access Point Status 


This page shows the current status and some basic settings of 
the device. 
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Uptime 
Firmware Version 
Build Time 


Oday:3h:10m:47s 
v2.2 
Mon Jun 28 17:45:19 CST 2010 


Wireless Configuration 


Channel Number 
Encryption 

BSSID 

Associated Clients 


AP 

2.4 GHz (B+G+N) 
RTK_3G_AP 

a 

WPA2 
00:e0:4¢:66:11:92 
Oo 


TCP/IP Configuration 


Attain IP Protocol 
IP Address 
Subnet Mask 
Default Gateway 
DHCP Server 
MAC Address 


Fixed IP 
192.168.1.254 
255.255.255.0 
192.168.1.254 
Enabled 
00:60:4c:66:11:90 


WAN Configuration 


Attain IP Protocol 
IP Address 

Subnet Mask 
Default Gateway 
MAC Address 


USBS3G Connected 
114.136.91.229 
255.255.255.255 
0.0.0.0 


4.4.6 USB 3G data card list supported 
At present, the USB 3G data cards are verified to be supported, as follows: 
1. HUAWEI EC189 (CDMA) 

HUAWEI E169U (WCDMA) 

QISDA H21 (WCDMA) 

ZTE MF637U (WCDMA) 

ZTE AC2726 (WCDMA) 

MOBILEPEAK Sample card (WCDMA) 

HUAWEI K4505 (WCDMA) 

Amoi HO1 (WCDMA) 

. Vibo D200 (WCDMA) 

4.4.7 The flash & SDRAM footprint for RTL8198 + RTL8192C 
Enable USB 3G will lead to 226KBytes increase in flash footprint, and decrease 600Kbytes in 
SDRAM footprint. 


CO NDA AR WN 


RTL8198 + RTL8192C demo board v630 run SDK v2.5 image (2011/06/10), the test result as follows: 


Configure \  Testentry | fw.bin (KB) MemFree (KB) 
Default 1962 16420 
Enable USB 3G 2188 15820 

4.4.8 4G LTE support 


Enable USB 3G will also enable 4G support. You can set WAN Access Type to LTE4G to use it. 


| eee 
WAN Interface Setup 


This page is used to configure the parameters for Internet network which connects to the WAN port of your Access Point, Here 
you may change the access method to static IP, DHCP, PPPoE, PPTP or L2TP by click the item value of WAN Access type. 


WAN Access Type: | |LTE4G a 


Host Name: | } 
MTU Size: 1500 (1280-1500 bytes) 


® Attain DNS Automatically 
Set DNS Manually 


DNS 1: 
DNS 2: 
DNS 3: 


Clone MAC. 


Address: oooooooo0000 =— Clone Mac | Restore Default MAC | 


bo eS enn 


4.5 WAPI support 
4.5.1 Enable WAPI support 


make linux_menucofig // To configure linux kernel settings 
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Menuconfig: 


Device Drivers ---> 


Network device support ---> 


Wireless LAN ---> 


Note: 


WAPI Support 


Support local AS 


// selected if WAPI support 


// selected if WAPI-CERT local AS support 


1) For wireless AP Mode, WAPI support two encrypt: WAPI-PSK and WAPI-CERT, while 
WAPI-CERT support local AS and remote AS. If [WAPI Support] is selected and [Support local 
AS] is not selected, WAPI-PSK and WAPI-CERT remote AS are supported. If both [WAPI 
Support] and [Support local AS] are selected, WAPI-PSK, WAPI-CERT remote AS and 
WAPI-CERT local AS are supported. 


2) For wireless Client Mode, WAPI only support WAPI-PSK. 


4.5.2 Flash and SDRAM size for WAPI support 
Flash and SDRAM size for WAPI support please refer to the table as follows, which is tested for 
RTL8198+92C (2010-11-19). 


Flash size (total) 


Estimate SDRAM size 


Run-time free memory 


for WAPI 
Disable WAPI support | Kernel: None. 1) No security: 
linux.bin 815122. 16136KB. 
User: 
root.bin 1007634. 
Total: 
fw.bin 1933934. 
Enable WAPI support, | Kernel: Kernel: 1) No security: 
Putedisable toca! AS linux.bin 831506. | wapiCrypto.o 28044, 15708KB. 
User: wapi_wai.o 21044. 2) WAPI-PSK: 
root.bin 1036306. | User: 15588KB. 
Total: WAPI certs related 64K. | 3) WAPI-CERT(remote AS): 
fw.bin 1981512. Total: 15516KB. 
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114624Byte. 


Enable WAPI support 
and enable local AS 


Kernel: 


linux.bin 831506. 


User: 


root.bin 1630226. 


Total: 


fw.bin 2580110. 


Kernel: 
wapiCrypto.o 28044, 
wapi_wai.o 21044. 
User: 


libcrypto.so.0.9.8 
1485928, 


libssl.so.0.9.8 278900, 
openssl 402724, 
ecdsatest 20776, 
openssl.cnf 9675, 
readFileSize 4708, 
loadWapiFiles 10956, 
storeWapiFiles 17320, 
aeUdpClient 41136, 
aseUdpServer 31544, 
genUserCert.sh 2808, 
initCAFiles.sh 1917, 
revokeUserCert.sh 1063, 
WAPI certs related 64K. 
Total: 


2424079Byte. 


1) No security: 
15500KB. 

2) WAPI-PSK: 
15440KB. 

3) WAPI-CERT(remote AS): 
15312KB. 

4) WAPI-CERT(local AS): 
13316KB. 


4.6 Mesh support 


4.6.1 How to setup Mesh Network 
To setup mesh network, choose AP+MESH or MESH mode on Basic Settings page shown as bellow 


figure. 
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WLAN Access Point 


Wireless Basic Settings -wlan2 


This page is used to configure the parameters for wireless LAN clients which may connect to your Access Pc 
network parameters. 


I~ Disable Wireless LAN Interface 
Band: 2.4 GHz (B+G+4N) ¥ 


Mode: AP+MESH »¥ Multiple AP | 

Network Type: [infrastructure 7 

SSD: IRTK map 29.5 Add to Profile | 
Channel Width: |40MHz ¥ 

Control 

Sideband: [Upper =] 


Channel 


Number: u = 


Figure | 
Choose Channel Width, Control Sideband, and a Channel Number. 


Click the menu item, Mesh settings, of home page to expand Mesh settings page shown as bellow 
figure. This page is greyed out by default. Make sure to correctly select wireless operation mode as 
AP+MESH or MESH mode on Basic Settings to unlock this page. 

Type in a Mesh ID and select a security suite. 


WLAN Access Point 


Wireless Mesh Network Setting 


Mesh network uses wireless media to communicate with other APs, like the Ethernet does. To do this, 
under AP+MESH/MESH mode. 


Enable Mesh 


Mesh D: [RTKmesKO ss s—i—s—S 
Eneryption: [WPAD AES) I 

Pre-Shared Key Format: [Passphrase >| 

Pre-Shared Key: [wee SS 


Apply Changes | Reset | Set Access Control | Show Advanced Information | 
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Figure 2, Page of setup mesh network by band 


After configuration is completed, please apply changes and reboot the device. 
All the mesh nodes should be configured as same band, Channel Width, Control Sideband, Channel 
Number, Mesh ID, and security suite. If the configuration is correct, mesh network will construct 


automatically. 


As Figure 2 demonstrate, there is a mesh network enabled with Mesh ID,RTK-mesh0, and take 
WPS2/AES as security suite. 
The security settings are independent to WiFi applied. Be sure of all the mesh nodes use the exactly 


pre-shared key or the mesh nodes will be connected but data is unreachable. 


MESH mode is for users who need to setup a device only capable of mesh network connectivity but 
without Wireless Access Point function, while AP+MESH mode has both mesh network connectivity 


and Wireless Access Point function. 


4.6.2 Mesh Network Information 
Users click the button named Show Advanced Information on web page as Figure 2, the browser tab is 
flushed by another web page as Figure 3. Users could read all mesh information through scroll bar. 
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WLAN Access Point 


Wireless Mesh Network Information 


These information is only for more technically advanced users who have a sufficient knowledge about wireless mesh network 
Neighbor Table 


Routing Table 


Portal Table 


Station List 


Proxy Table 


Figure 3, Web Page of Mesh Information 
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4.6.2.1 Neighbor Table 
This table shows basic information of all mesh nodes connected. Any mesh nodes configured with the 
same settings exceed proper distance, or behind some block that extremely degrade signal strength, or 


limited by Access Control List will not be present. 


4.6.2.2 Routing Table 

All mesh nodes discovered a routing path to reach are showed as this table. If some mesh node 
broadcast that it supports to be a Portal, the Portal Enable attribute recorded as “ recorded as “yes”. 
The Metric attributes explain cost of reaching this mesh node and Hop Count describe the path 
distance. 

For example in Figure 3, 006d6573681d and 006d6573684d are 1-hop reachable. Path to reach 
006d6573681d is better than 006d6573684d because of lower metric. 006d6573683d is 2-hop 
reachable, and any packets with destination relative to 006d6573683d will be forwarded to the 
Next-hop Mesh Node, 006d6573684d. 


4.6.2.3 Portable Table 

All mesh nodes broadcast that it supports to be a Portal, which means they are capable to forward 
traffic to PC plugged in its Ethernet port. 

4.6.2.4 Station List 

Basic information of all WiFi clients connected to Access Point interface are listed. 

4.6.2.5 Proxy Table 

Data of this table is constructed through traffic learning. The learning happens to all packets received 
with mesh network formatted, or which are forwarded from its own Ethernet LAN/WiFi. 

4.6.2.6 Refresh 

Flush this page for latest information by click this button. 

4.6.3 Layer-II Filtering in Mesh Network 

If there is requirement to limit traffic go-through some link in mesh network, users could access web 
page as Figure 4 below. Click the button named Set Access Control at page Figure 2 shows will display 
this page. 

There are three policies for limit traffic. Disable means turn off this functionality. All rules stored will 
not be cleaned up unless users demand. Allow makes packets destination of MAC(s) in rule(s) pass 
through, or Deny drop packets fit rules. 

Rules append could be removed through clicking two buttons, Delete Selected or Delete All. Delete 
Selected will delete those rules users checked at check box. Delete All will remove all entries. 


Reset will clean up all changes ever done, including MAC address just input and policy just choose. 
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WLAN Access Point 


Access Control List for Mesh Network 


If you choose 'Allowed Listed', only those mesh nodes whose wireless MAC addresses are in th: 
those mesh nodes in the list will not be able to create connections. 


Mode: © Disable © Allow © Deny 


MAC Address: Comument: 
Apply Changes | Reset | 


Current Access Control List: 


MAC Address Comment = Select, 
Reset | Delete Selected | Delete All 


Figure 4, Access Control List for Mesh 


This L-II filtering is independent to Access Control for WiFi. 
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4.6.4 Constrain of Mesh Network Application 

1). Because Mesh Network will be L2 connected to form a LAN, please make sure that there is only 
one DHCP server/Gateway in one mesh network. Or multiple DHCP servers will deliver IP to 
clients within the same LAN and suffer IP confliction. 

2). Although each mesh node is capable to connect 15 other mesh nodes, it is suggested to deploy 5 
mesh nodes at most within an area such as at home. Or too much media access contention will 
drop throughput dramatically. In general, it is more then enough to deploy 3 nodes. 

3). Universal Repeater Mode can be enabled in AP+MESH and MESH mode. However only one 
mesh node in the mesh network can have this function enabled. Multiple repeaters may cause the 


channel of mesh to flutuate. 


4.6.5 How to enable Mesh using SDK 

To enable mesh network support, it is necessary to configure kernel and user-space application of SDK 
through menuconfig, as following demonstrated. 

= First, configure the kernel. 

Select “Config kernel” 


Config kernel 


, and then exist. 


Select option of “Device Drivers”. 


DOR HORM 


ie 
evice Drivers ---> 
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And choose to configure “Network device support”. 


[W] Network device support ---> 
I 
ay 
r 


After choose “Wireless LAN”’, 


ireless LAN ---> 


You will see the page as below. 


TL Mesh Support 


Select the option “RTL Mesh Support” then save and exit to store the configuration. 
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= Second, turn on “pathsel” application as well, which is under “Config users” option. 


Select “Config users” and then exist. 


RLX Linux Configuration 

Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y¥> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > module 


select components 

Selected Target (rtlé881a) co one 

Selected Kernel (linux-2.6.30) ---> 

Selected Busybox (busybox-1.13) ---> 

Selected toolchain (rsdk-1.5.5-5261-EB-2.6.30-0.9.30.3-110714) 
rtlé19xD 

Selected Board Configuration (8586148+68367RB+92E) ---> 
config components 

Config kernel (NEW) 

Contig users 

Config busybox 

Load default settings 

Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


It will bring up “Applications” submenu. 


Enable pathsel application. 


the menu. 


RLX Linux Configuration 


<Enter> selects submenus --->. Highlighted letters are hot! 


les, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
tcluded <M> module < > module capable 


= 


minidina 
dina_dms 
miniigd 
mini_upnp 
mld proxy 
wp daemon 


netatalk 


nfibi 


nfbi host 


mrbs 


ntpclient 
openssl 


bea 
[ ] 
ed 
Leal 
[isl 
Led 
[ ] mt-daapd 
[ ] 
[o 
[ ] 
Dest 
Ea 
[ ] 


[.] pathsel 
{[ ] pmc utils 
[ ] python support 


[ ] reload 


Save and exit to store the configuration, and then compile SDK to generate mesh image. 
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4.7 VLAN support 
(only support Linux VLAN since sdk-3.4.11) 


4.7.1 LINUX VLAN FEATURE 
4.7.1.1 What’s Linux VLAN? 

Linux VLAN is based on linux kernel support for software VLAN process, combined with 
hardware packet process engine(L2/L3/L4), and appended with enhanced features. 

VLAN doesn’t simply mean L2 process anymore, and it’s combined with higher layer (L3/L4) 
process. Therefore, users can create VLAN groups with different ‘forwarding rule’ (NAT/Bridge). In 
NAT groups, packet flow between LAN ports and WAN is 13/l4([P-routing/NAPT) processed; while in 
bridge groups, LAN ports and WAN are bridged together, and packets are forwarded only in L2. 
Multiple groups (NAT/bridge) can be configured and work simultaneously. 

Two different selectable modes are provided, wan-tag mode and source-tag mode: 

In wan-tag mode, when packets are forwarded from LAN to WAN, VLAN tag/vid is determined 
by WAN port VLAN-setting; 

In source-tag mode, when packets are forwarded from LAN to WAN, VLAN tag/vid is 
determined by source LAN port VLAN-setting; 

Hardware NAT/NAPT is supported in both wan-tag mode and source-tag mode. 


4.7.1.2 Enable/disable Linux VLAN 
1. Enable ’802.1Q VLAN Support’ and ‘Make linux vlan support RTK AP router’ in kernel 
menuconfig; 
2. If source-tag mode is to be used, select ‘Enable source tag support in linux vlan’; If wan-tag 
mode is to be used, un-select ‘Enable source tag support in linux vlan’; 

Location: 

-> Networking support (NET [=y]) 


-> Networking options 
[*] 802.1Q VLAN Support 
[*] | Make linux vlan support RTK AP router 


[Fl Enable source tag support in linux vlan 


] Enable RealTek Guest Zone 
] IGMP/MLD snooping 

] VLAN filtering 
] 
] 


Make Linux vlan support RTK AP router 
Enable source tag support in linux vlan (NEW) 
MVRP (Multiple VLAN Registration Protocol) support 
DECnet Support 

ANSI/IEEE 802.2 LLC type 2 Support 
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3. Un-select “Support rtk vlan feature” in kernel menuconfig. 
Location: 
-> Device Drivers 
-> Network device support (NETDEVICES [=y]) 
-> Options for Realtek SoC (RTL_819X_SWCORE [=y]) 


] Enable realtek fast filter 

] Enable Ethernet Private Skb 

] Enable Dump Ethernet Private Skb Info 
] Hw multicast cam support 

] Enable proc filesystem for debug 

] Enable JUMBO frame support 

] Enable log print system for debug 


Support _rtk vlan feature im 
S masmission vlan feature 


] Support dhcp ip and port bind 
] Disable 802.3az EEE feature 
] Support reinit switch core 


4. If enable Linux VLAN wan-tag mode, and hw- NAT is to be used, please also select “Enable RTL 
Hardware NAPT” in kernel menuconfig. 
Location: 
-> Device Drivers 
-> Network device support (NETDEVICES [=y]) 
-> Options for Realtek SoC (RTL_819X_SWCORE [=y]) 
-> Config for Layered Driver Features 


-> Hardware Features Selection (<choice> [=y]) 


nable RTL Hardware NAPT 


( ) Enable RTL Hardware Multicast Only 
( ) Enable RTL Hardware switch onlylj 


5. Enable vconfig in busybox menuconfig. 
Location: 
-> Networking Utilities 


_raceroute 
dhcp server (udhcpd) 


dhcp ent (udhcpc) 
} conta gill 


f 1 zcip 
[ ] cpsvd 
[ ] dpsvd 


Cnllanenitaadtaeen mentee 
Gen) fd ed end ed md ems 
h 
ot 
me] 


4.7.1.3 Configure Linux VLAN UI (source-tag mode) 

In source-tag mode, when packets are forwarded from LAN to WAN, VLAN tag/vid is 
determined by source LAN port VLAN-setting; 

Basic rules/limitations for VLAN configuration in source-tag mode,: 

@ NAT group should include both LAN ports and WAN, and at most 1 NAT group can be configured; 
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@ Multiple bridge groups can be configured; 


@ NAT group can be configured to use hardware NAT (hardware processed NAT) or software NAT; 


Ports setting should be all tagged or all untagged in NAT/Bridge group; 
At most | Bridge group can be untagged, and the NAT group can be tagged/untagged freely; 
When a port receives a packet with no tag, it use PVID (default vlan id) setting to identify which VLAN 
the packet belongs to. PVID is set automatically when VLAN is configured (init/add/delete), and normally 
there’s no need to change PVID setting. 

Note: Since LAN ports tag/untag setting is only to affect behavior of packets from LAN to WAN, all LAN 


ports are in fact untagged in source-tag mode. 


Example: 

group |: 

vid: 100 

forwarding rule: NAT 

member ports: portl, port2, wlanl, port5 (untagged) 


~“ Enable 802.1Q VLAN 
VLAN ID(1-4095): 100 


Forwarding Rule: NAT | Hardware NAT: ¥ 
Port Member Tagged 

porti ¢ 

port2 ¢ 


port4 

ports (WAN) 7 
wlanl 

wiani-val 

wlani-va2 

wlani-va3 

wlani-va4 


wlani-vxd 
group 2: 
vid: 200 
forwarding rule: Bridge 


member ports: port3, port4, wlanl-val, port5 (tagged) 
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“ Enable 802.1Q VLAN 
VLAN ID(1-4095): 200 


Forwarding Rule: Bridge ¥ Hardware NAT: 
Port Member Tagged 


port4 
portS (WAN) 


wlanl 


4 
.s 


wlani-val ¢ ¢ 
wlani-va2 
wlani-va3 
wlani-va4 


wlani-vxd 


Then VLAN table shows as follow: 


Current VLAN Table: 
VLAN ID Forwarding Rule Tagged Ports Untagged Ports Select 


porti, port2, 
portS(WAN), wlan1 


ports, port4, portS(WAN ) ' 
wlani-val 


Delete Selected | Delete All | Reset 
With such VLAN setting as the vlan table shows: 


100 NAT(hw) 


200 Bridge 


(1) LAN/WLAN ports can communicate with each other within a VLAN group, but communication between the 
group 100/200 is blocked; 

(2) Ports in group 100 can all access DUT (webserver/DHCP...), but ports in group 200 can’t access DUT; 

(3) When group 100 packets are forwarded out of WAN port (NAT processed), they are untagged; 
When group 200 packets are forwarded out of WAN port (Bridge processed), they are added with VLAN tag 
200; 

(4) If WAN->LAN packets carry VLAN tag 200, it’s regarded as belonging to VLAN group 200, and forwarded 
back (Bridge processed) to LAN/WLAN ports in the same group; 
If WAN->LAN packets carry no tag, it’s regarded as belonging to VLAN group 100(as PVID setting indicated), 
and forwarded back (NAT processed) to LAN/WLAN ports in group 100 (or DUT). 


4.7.1.4 Configure Linux VLAN UI (wan-tag mode) 

In wan-tag mode, when packets are forwarded from LAN to WAN, VLAN tag/vid is determined 
by WAN port VLAN-setting; 

Basic rules/limitations for VLAN configuration in wan-tag mode: 


@ InNAT groups, LAN ports and WAN should be configured separately (should be in different groups, 
namely NAT-LAN/NAT-WAN); 
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@ Only 1 NAT-WAN group (only WAN port) can be configured; 
@ Multiple NAT-LAN/bridge groups can be configured; 


@ Only I NAT-LAN group can use hardware NAT (hardware processed NAT, in other NAT-LAN groups 
NAT can only be software processed); 


At most | VLAN group (including NAT-WAN and Bridge) can include untagged WAN port; 

When a port receives a packet with no tag, it use PVID (default vlan id) setting to identify which VLAN 
the packet belongs to. PVID is set automatically when VLAN is configured (init/add/delete), and normally 
there’s no need to change PVID setting. 


Example: 

group |: 

vid: 100 

forwarding rule: NAT (NAT-LAN, use hardware NAT) 
member ports: portl, port2, wlan] (all untagged) 


“Enable 802.1Q VLAN 
VLAN ID(1-4095): 100 


Forwarding Rule: NAT ¥ Hardware NAT: “ 
Port Member Tagged 

porti ¢ 

port2 ¢ 


port4 

ports (WAN) 

wian1 ¢ 
wiani-val 

wlani-va2 

wlani-va3 

wlani-va4 

wlani-vxd 


group 2: 
vid: 200 
forwarding rule: Bridge 


member ports: port3/port4/wlan1 -val (untagged), port5(wan, tagged) 
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¢ Enable 802.19 VLAN 
VLAN ID(1-4095): 200 


Forwarding Rule: | Bridge ¥ Hardware NAT: 


Port Member Tagged 
port1 
port2 
port3 7 
port4 ¢ 
ports (WAN) ¢ ¢ 
wianl 
wiani-val ¢ 
wlani-va2 
wlani-va3 
wlani-va4 
wlani-vxd 
group 3: 
vid: 300 


forwarding rule: NAT (NAT-WAN) 
member ports: portS (wan, untagged) 


%) Enable 802.1Q VLAN 
VLAN ID(1-4095): 300 


Forwarding Rule: NAT ¥ Hardware NAT: 


Port Member Tagged 
portl 
port2 
port3 
port4 
ports (WAN) 7 
wiani 
wlani-val 
Then VLAN table shows as follow: 
Current VLAN Table: 
VLAN ID Forwarding Rule Tagged Ports Untagged Ports Select 
100 NAT(hw) porti, port2, wlani 
200 Bridge portS(WAN) port3, port4, wlani-val 
300 NAT port5(WAN) 


Delete Selected | Delete All | _Reset | 


With such VLAN setting as the vlan table shows: 

(1) LAN/WLAN ports can communicate with each other within a VLAN group, but communication between the 
group 100/200 is blocked; 

(2) Ports in group 100 can all access DUT (webserver/DHCP...), but Ports in group 200 can’t access DUT; 

(3) When packets from LAN ports in group 100 are forwarded out of WAN port (NAT processed), they are 
untagged; 
When packets from LAN ports in group 200 are forwarded out of WAN port (Bridge processed), they are 
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added with VLAN tag 200; 

(4) If WAN->LAN packets carry VLAN tag 200, it’s regarded as belonging to VLAN group 200, and forwarded 
back (Bridge processed) to LAN/WLAN ports in the same group; 
If WAN->LAN packets carry no tag, it’s regarded as belonging to VLAN group 300(as PVID setting indicated), 
and forwarded back (NAT processed) to LAN/WLAN ports in group 100. 


4.7.2 RTK VLAN 
4.7.2.1 RTK VLAN 
4.7.2.1.1 What’s RTK VLAN? 
RTK Vlan is an enhanced vlan feature based on 802.1Q, and it is processed by software. In RTK 


vlan, user can per-port configures the following features: 
@ Disable/enable RTK vlan feature 
@ vlan tag/ untag when packet tx from the port 
@ different/same vlan id for ports 
@ priority for every port 
@ cfi for every port 
@ if wan is vlan tagged, the tag vlan id is the source vid 


4.7.2.1.2 How to implement in Linux 
For example, rtk vlan is configured as following diagram. 


ite contents VLAN Settings 
Setup Wizard 
A = Entries in below table are used to config vlan settings. VLANs are created to provide the segmentation services 
= traditionally provided by routers. VLANs address issues such as scalability, security, and network management. 
ettings 
Interface 
(¥] Enable VLAN 
Fi 
BH Port Filtering 
i MAC Filtering Ethemet Port! LAN 4090 [7 \~ 
BH Port Forwarding — —— 
URL Filtering Ethemet Port2. LAN 4090 |o bal 
- coe Ethemet Pont3 LAN 500 BS 
VLAIN I 
i Qo ri Ethemet Portt LAN 
& CI Wireless Primary AP LAN 
& Virtual AP1 LAN 
= Virtual AP2 LAN 
=| Virtual AP3 LAN 
=| 
B Virtual AP4 LAN 
= Ethemet Port5 WaN i) jo 


(Aray Cine) (Ree) 


Both port! and port2 are the member port of vlan 4090. It means that port! and port2 can 
communicate with each other, port! and port 3 can NOT communicate with each other. 


The filed tag means that the ports only received vlan tagged packets whose vid is 4090 and 
should transmit with vlan tagged(vid is 4090). 
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If filed tag is disable, both vlan tagged (vid is 4090) and vlan untagged can be received by the 
port. 


If packet received from portl and with vlan tagged (vid is 4090) will be transmitted to wan 
through wan port, packet should be vlan tagged (vid is 4090) when wan port is vlan tag enable and 


packet should be vlan untagged when wan port is vlan tag disable. 


4.7.2.1.3. How to enable/disable RTK vlan feature 
1. Menuconfig: 


Device Drivers ---> 
[*] Network device support ---> 
[*] Options for Realtek SoC ---> 


[*] | Support rtk vlan feature 


£E wenjian_jia@APServer197: /main_trunk - Xshell 3.0 


File Edit Vier Tools Window Help 
Hea-ac|a- &® 2 B~ @- GW ” | Font Courier New viz ¥ 


Addre ssh: /fwenjian_jia:eeeemoedO1 72, 29. 38.197: 22 ~ 


1 172.29.38.197 | 2 172.29.38.197 | 3 172.29.38.197 


Options for Realtek Soc 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


--- Options for Realtek Soc 
Config MIPS16-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features ---> 
J Enable iptables rule to RTL ACL rule 
] Enable realtek fast filter 
] Enable Ethernet Private Skb 
] Support HW Qos 
] Enable proc filesystem for debug 
foal Enable log print system for debug 
lll Enable rome perf 
] 
J rtk vlan for cable modem 
J add rtk vlan bridge feature 
] Support rtl hw vlan feature 
] Disable 802.3az EEE feature 


2. RTK vlan feature 


User can use command echo “0”>/proc/rtk_vlan_support to disable rtk vlan feature, and use 


command echo “1”>/proc/rtk_vlan_support to enable rtk_vlan_feature. 


4.7.2.2 RTK VLAN BRIDGE FEATURE 
Some customers require AP support VOIP, IPTV and so on. So we add a feature to enable lan port 
can bridge with wan port to forward VOIP and IPTV stream based on RTK VLAN support. Then it is 
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still use CPU software to process vlan. 


4.7.2.2.1 How to enable/disable RTK vlan feature 
1. Menuconfig: 


Device Drivers ---> 
[*] Network device support ---> 
[*] Options for Realtek SoC ---> 
[*] | Support rtk vlan feature 


[*] rtk_vlan_bridge feature 


© wenjian_jia@APServer197:/backup/wenjian_jia/branch_2.5t — Xshell 3.0 


File Edit View Tools tindow Help 
na-@¢|a- MS B- B- SH” stot [Cowie ty VIZ v 
Ad ssh: /fwenjian_jia@172. 29. 38. 197:22 Na 


1 172.29.38.197 | 2 172.29.38.197 3 172. 29.38. 197 


Options for Realtek Soc 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


--- Options for Realtek Soc 
Config MIPS16-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features ---> 
i] Enable iptables rule to RTL ACL rule 
] Enable realtek fast filter 
] Enable Ethernet Private Skb 
] Support HW Qos 
1 Enable proc filesystem for debug 
J Enable rome perf 
J Support rtk vlan feature 
1] rtk vlan for cable modem 
rtl hw vlan feature 
Disable 802.3az EEE feature 


< exit >  < Help > 


2. RTK vlan bridge feature 


User can use command echo “0”’>/proc/rtk_vlan_support for disable rtk vlan feature, and use 


command echo “1”’>/proc/rtk_vlan_support for enable rtk_vlan_feature. 


4.7.2.2.2 How to implement in Linux 
For example, If we want port4 to bridge with wan port, then we can config port as bridge 


forwarding rule, just as follows: 
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hy Realtek WLAN AP Webserver — Microsoft Internet Explorer 
RHe) @) SEW hea TAG) hw 
On-O HAO \a yume © 8-25 OHA 


Siti D) |) ne tp: //192. 168. 1. 254/h ; Oy Ey 


A AREALTEK WLAN Access Point 


= Site contents: VLAN Settings 
B Setup Wizard 
B Operation Mode 
® Wireless 


Entries in below table are used to config vlan 
© TCP/P Settings settings. VLANs are created to provide the 

Bi LAN Interface segmentation services traditionally provided by 

B WAN Interface routers. VLANs address issues such as scalability, 
security, and network management. 


B Port Filtering 


B IP Filtering “Enable VLAN 
B MAC Filtering 
B Port Forwardi 
NEE emis naan MM a Ue 
& DMZ 
B VLAN Ethernet Portl (200 | 
B Qos v Ethernet Port2 [maT yl v 200 o” 
™ Management vy] Ethernet Port3 — ‘MAT yl vy) 200 ov 
v Ethernet Port4 LAN Bridge ¥ ov 
Wireless 1 -— 
Primary AP LAN —— 
Wireless 1 
Virtual AP1 Ken — 
Wireless 1 —| 
Virtual AP2 ofl 
Wireless 1 
Virtual AP3 Len 
Wireless 1 -—— 
Virtual AP4 es 
v Ethernet Port5 WAN 1 ov 
Apply Changes | [Reset ] 


Config as this web-page, port4 will be bridge with wan, and port0-3 will be nat with wan. 
And Ethernet Port4 “Tag” is enabled; the packets from port4 to wan port will be tagged with vid 


100. That means if you want the packets from lan port to wan port to be tagged, you just need to 


enable “Tag” on lan port. 


Besides, if you want the packets generated by AP, such as the packets sent by pppoe from AP also 
tagged, then you need to enable “Tag” on Wan port. 
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eT Realtek WLAN AP Webserver — Microsoft Internet Explorer 


RH+®) mE) SEW wea TAG eo 


Q ae - 


[x] [2] G xe prvmmr @ B-B 


Wee 


REALTEK, 


= Site contents: 
B Setup Wizard 
B Operation Mode 
® Wireless 
= TCPAP Settings 
B LAN Interface 
B& WAN Interface 


Siidik @) |) netp://192. 168. 1. 254/home. asp 


WLAN Access Point 


Ov GE) #2 


VLAN Settings 


Entries in below table are used to config vlan 
settings. VLANs are created to provide the 
segmentation services traditionally provided by 
routers. VLANs address issues such as scalability, 
security, and network management. 


& Port Filtering 
B IP Filtering ud 
B MAC Filtering 
B Port Forwardi 


Enable VLAN 


PT sate omnes saan Ma ae rots a 
B DMz 
B VLAN vy Ethernet Portl LAN NAT v iv 200 av Oo 
B Qos I Ethernet Port2 LAN NAT ¥ v 200 os Oo 
™ Management My Ethernet Port3 LAN NAT ¥ v 200 ov Oo 
v) Ethernet Port4 LAN Bridge | cu 100 ov O 
Wireless 1 
Primary AP a 
Wireless 1 
Virtual AP1 a 
Wireless 1 — 
Virtual AP2 Le, — 
Wireless 1 
Virtual AP3 in 
Wireless 1 — 
Virtual AP4 ae —— 
Vv] Ethernet Port5 WAN | 1 ov Oo 


Apply Changes | { Reset } 


Then pppoe of DUT will send packets tagged with vid = | to dial up. 


4.7.2.3 HW VLAN FEATURE 
HW vlan feature also support forwarding rule as bridge and nat between lan port and wan port, it 
uses hardware ASIC to process vlan. Only rtl8196ct and rtl8198t support hw vlan feature. 


4.7.2.3.1 How to enable/disable RTK vlan feature 
1. Menuconfig: 
Device Drivers ---> 


[*] Network device support ---> 


[*] | Options for Realtek SoC ---> 


[*] | Support rtk vlan feature 


[*] 


Support rtl hw vlan feature 
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£ wenjian_jia@APServer197T: /main_ trunk -— Eshell 3.0 


File Edit View Tools Window Help 
Ha-@C¢|a- BA & B~@- SW” : Font |courier ew vie 


Addres ssh: //wenjian_jia:eeeomotetO 172, 29.38. 197: 22 “ 


1 172.29.38.197 | 2 172.29.38.197 | 3 172.29.38.197 


Options for Realtek Soc 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


--- Options for Realtek Soc 

Config MIPS16-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features ---> 
Enable iptables rule to RTL ACL rule 

] Enable realtek fast filter 
*] Enable Ethernet Private Skb 

Support HW Qos 
Enable proc filesystem for debug 
Enable log print system for debug 
Enable rome perf 
*] Support rtk vlan feature 
rtk vlan for cable modem 


Disable 802.3az EEE feature 


< Exit > < Help > 


2. RTL HW vlan feature 


As rtl HW vlan feature has almost the same function with rtk vlan & rtk vlan bridge feature. The 


difference is rt] HW vlan using hardware ASIC to process vlan, and rtk vlan bridge feature use CPU. 


Besides, only rtl8196ct & rtl8198t support rtl HW vlan feature. So if you want to use HW vlan, 
just select “Support rtk vlan feature” & “Support rtl HW vlan feature” in menuconfig. 


4.7.2.3.2 How to implement in Linux 
The default forwarding rule for lan ports is nat, so if you want all lan port just do nat with wan 
port, then you need not to configure lan port on web any more. Anyway, if you want to configure a lan 


port, for example port0, to bridge with wan, then you can configure web as follow: 
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aie | T-* b+ Cae XH 


WLAN Access Point 


contents VLAN Settings 
etup Wizard 
Operation Mode 


Entries in below table are used to config vlan settings. VLANs are created to 
provide the segmentation services traditionally provided by routers. VLANs 
address issues such as scalability, security, and network management. 


B Port Filtering 
“| Enable ¥LAN 
BB IP Filtering ae 
B MAC Filtering 
ce nn en re 
B URL Filtering 
B Diz [v] Ethernet Port! |Bridge vy) [¥] (3022 }2 
A age [] Ethernet Port2 LAN 
Bi Route Setup a Ethernet Port3 LAN 
2 a Ethernet Port4 LAN ir | 
Oo ies 1 Primary LAN 
Wireless 1 1 
Virtual AP1 na 
Wireless 1 i 
Virtual AP2 me = 
Wireless 1 
Virtual AP3 LAN 
Wireless 1 | 
Virtual AP4 Ee Le 
Ethernet Port5 Wan =| NAT v| i oo 


[ Apply Changes J [Reset } 


Then portO can bridge with wan port to forward IPTV & VOIP with vid = 3022. And other lan 
ports nat with wan, the packets from these lan port should be untag, and these packets go out to wan 


port will tagged with vid = 8. 


4.8 I2C UART support 
4.8.1 Enable I2C UART in bootloader 
4.8.1.1 Modify code for GPIO pin in bootloader 
According hardware designed; please modify the GPIO pin mux which is used by I2C UART. 
The GPIO pin used by I2C UART is defined in boot/serial_sc16is7x0/8250_sc16is7x0.c 
For example, following configuration means I2C UART use GPIO pin D3~D6. 
#define SC16IS7X0O_RESET I2C_GPIO_ID( 'D’, 3) // RESET = D3 


#define SC16IS7X0_SCL I2C_GPIO_ID( 'D’', 4) //SCL= D4 
#define SC16IS7X0_SDA I2C_GPIO_ID( 'D', 5) //SDA=D5 
#define SC16IS7X0_IRQ I2C_GPIO_ID( 'D’, 6) //TRQ = D6 


4.8.1.2 bootloader menuconfig 
Choose the correct configuration related to I2C UART in bootloader’s menuconfig. 
make menucofig // To configure bootloader settings 
Menuconfig: 


Target Platform Selection ---> 
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Support SC16IS7x0 I2C UART _// selected 
Support SC16IS7x0 console // selected 


(14.746MHz) XTAL1_ CLK // XTAL1_CLK should be set based on hardware 


ParqeLsPatecormselece fon 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help. Legend: [*] built-in 


[ ] excluded <M> module < > module capable 


--- Choose a Vendor/Product combination. 


(RTL8196C) roduct 
(Draml16M_16Mx1_16bit) s the target of HW Setting 
(SPI_FLASH) s FLASH Type 
(BOOT _SIO_ 8198 8196C) s SPI IO Type 
[*] PI CLOCK LIMIT SPEED<40MHz 
[*] PI FLASH SINGLE IO MODE(CAN ENABLE DHCP) 


0 I2C UART (NEW) 
0 console 


(40000) INUX image flash offset end 
: v(t) 


4.8.2 Enable I2C UART in kernel 
4.8.2.1 Modify code for GPIO pin in kernel(only valid at kernel 2.6.30) 


According hardware designed, please modify the gpio pin mux which used by I2C uart. The gpio 


pin used by i2c uart is defined in linux-2.6.30/drivers/serial/8250_sc16is7x0.c 
For example, following configuration means i2c uart use gpio pin D3~D6. 
#define SC16IS7X0_RESET I2C_GPIO_ID( 'D’, 3) // RESET = D3 


#define SC16IS7X0_SCL I2C_GPIO_ID( 'D’, 4) //SCL= D4 
#define SC16IS7XO0_SDA I2C_GPIO_ID( 'D', 5) //SDA=D5 
#define SC16IS7X0_IRQ I2C_GPIO_ID( 'D', 6) //TRQ = D6 


4.8.2.2 kernel menuconfig 
1) Set ttysl as console tty. 


make linux_menucofig // To configure linux kernel settings 
Menuconfig: 


Kernel hacking ---> 


(console=ttyS 1, 38400 root=/dev/mtdblock1) Default kernel command string 
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Kernel hacking 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


Enable IRQFLAGS trace support 

Enable _ deprecated logic 

Enable _ must_check logic 

1024) Warn for stack frames larger than (needs gcc 4.4) 
Magic SysRq ke 

Enable unused/obsolete exported symbols 


efault kernel command 


2) Modify the 8250/16500 serial port number. 


make linux_menucofig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
Character devices ---> 
Serial drivers ---> 


Maximum number of 8250/16550 serial ports = 2 

Number of 8250/16550 serial ports to register at runtime = 2 

Select SC16IS7x0 series (I2C bus) support and select correct Crystal for I2C 
based on hardware. 


Serial drivers 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y¥> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. 
Legend: [*] built-in [ ] excluded <M> module < > module capable 


HB othe item you wish to select followed by the <SPACE BAR>. Press 
x Console on 8250/16550 and compatible serial port 

Maximum number of 8 ial ports 
Number of 8250/16550 serial ports to register at runtime 
il Extended 8250/16550 serial driver options 
*** 8250 compatible port support ***| 
SC1I6IS7x0 series (I2C bus) support 
Crystal for SC16IS7x0 XTAL1 (14.7465 MHZ 
Console on SC16IS7x0 port (ttys1) 


Tel 


(NXP demoboard) }) 


el 
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4.9 Pocket AP support 


At present, pocket AP is supported at RTL8196C(kernel 2.6.30). Configure pocket AP is as 


follows: 


make menucofig 


// To configure linux kernel settings 


And the linux kernel configurations refer to the pic as follows. 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


select components 

Selected Target (rt18196c) ---> 
Selected Kernel (linux-2.6.30) 
Selected Busybox (busybox-1.13) 


Selected toolchain (rsdk-1.3.6-4181-EB-2.6.30-0.9.30) ---> 


5 {lin t Rot jap) > 


Selected Board Configuration (SPI flash 5 Squashts) ===> 


Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


4.10 Wireless client mode 802.1x support 


Note: at present, wireless client mode 802.1x test as follows: 


1) md5/ peap-mschapv2 / tls with linux radius server 


2) md5/ peap-mschap v2 / tls with windows 2003 radius server 


Enable wireless client mode 802.1x support as follows: 


make linux_ menucofig 
Menuconfig: 
Device Drivers ---> 
Network device support ---> 
Wireless LAN ---> 
Client Mode 802.1x Support 
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// To configure linux kernel settings 


// selected 


74 


Wireless LAN 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] 
built-in [ ] excluded <M> module < > module capable 


Wireless LAN (pre-802.11) 
] Wireless LAN (IEEE 802.11) 
] Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL8192C/D 802.11b/g/n support 

8198 clock source at 40Mhz| 

Realtek 8192C wireless support 
Private skb buffer management 
Client Mode Support} 
Client Mode upport 
Repeater Mode support 


+ > OF OO 


4.11 Hardware NAT 
4.11.1 Hardware NAT description 


Hardware NAT can be regarded as cache of Linux IP conntrack in hardware, without any 


relationship to iptables rules. 
Hardware NAT table entry is tried to add when Linux PS (Protocol Stack) create IP conntrack. 
Hardware NAT table entry is tried to delete when Linux PS destroy IP conntrack. 


When Linux PS IP conntrack timeout, it will be checked whether there is no traffic leading to 


timeout or hardware offload leading to fake timeout. 


Note: No API of hardware NAT is offered. All modifications of hardware NAT are patched to 


Linux kernel. So operations on Linux IP conntrack will modify hardware NATP entry synchronously. 


For example: 


/* flush all ip conntrack & hw nat table entry */ 
void flushAllNaptSession (void) 


{ 
struct net *net; 
for_each_net (net) { 
nf_conntrack_flush (net, 0, 0); //clean conntrack table 
} 
} 


4.11.2 Proc files related to hardware NAT 


1) Name: fast_nat 
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Path: /proc/fast_nat 
Description: Flags for fast path control 
Input Format: 
echo “$FLAG” > /proc/fast_nat 
Input Para: 
* the unit is non-zero: fastpath enabled 
* the unit is 0: fastpath disabled 
* “echo 0 > /proc/fast_nat”: disable fastpath. 
* “echo | > /proc/fast_nat”: enable fastpath. 
* “echo 2 > /proc/fast_nat”: clean the conntrack table. 
Output Format: 
$FLAG 
Output Para: 
* 10: disable fastpath. 
* 11: enable fastpath. 
* 12: clean the conntrack table. 


2) hw_nat 
Path: /proc/hw_nat 


Description: Flags for hardware NAT control 
Input Format: 

echo “$FLAG” > /proc/hw_nat 
Input Para: 

* the unit is non-zero: hardware NAT enabled 

* the unit is 0: hardware NAT disabled 

* “echo -1 > /proc/hw_nat”: hardware NAT disabled, change to gateway mode. It will flush 

hw 13 table and hw ip table, when echo | > /proc/hw_nat again, 
hw nat can not work again. This value is only used when br0 or 
ethl’s ip set as A or B class network address. 

* “echo 0 > /proc/hw_nat”: hardware NAT disabled, change to gateway mode. It will not 
flush hw 13 table and hw ip table, when echo | > /proc/hw_nat 
again, hw nat can work again. 

* “echo 1 > /proc/hw_nat”: hardware NAT enabled, change to gateway mode. 

* “echo 2 > /proc/hw_nat”: Change to bridge mode. 

* “echo 3 > /proc/hw_nat”: Change to WISP mode. 

* “echo 4 > /proc/hw_nat”: simply disabled the hardware NAT. 

* “echo 5 > /proc/hw_nat”: simply disabled the hardware NAT. 

* “echo 8 > /proc/hw_nat”: simply disabled the hardware NAT. 
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‘echo 9 > /proc/hw_ nat”: init hardware NAT parameters. (Must init before hardware 


NAT works) 

Output Format: 
$FLAG 

Output Para: 
* 0: gateway mode & hardware NAT disabled. 
* 1: gateway mode & hardware NAT enabled. 


* 2: bridge mode. 
* 3: WISP mode. 
* 4: hardware NAT disabled. 
* 5: hardware NAT disabled. 
* 8: hardware NAT disabled. 


* Q: hardware NAT parameters have already initialized. 


* others: no means 


3) Name: nf_conntrack 


Path: /proc/net/nf_conntrack 


Description: this proc can indicate whether hardware NAT is applied to each IP conntrack. 


4.11.3 Hardware NAT characteristic & limitation 
Following is the characteristic & limitation about hardware nat 


1) 


2) 
3) 
4) 
5) 
6) 
7) 
8) 
9) 


support static/dhcp/pppoe wan type, not support vpn tunnel (PPTP/L2TP/multi-PPPoE 
wan type. 


not support IP conntracks which need do ALG. 

when URL filter enabled, must disable hardware nat. 
when enable software qos, must disable hardware nat. 
when enable rtk vlan, must disable hardware nat. 

not support IP fragment packets. 

support ipv4, not support ipv6. 

support tcp/udp, not support icmp... 


not support encryption packets (e.g.: IPSec). 


10) not support A or B class network address. 


11) support server port / trigger port / DMZ/ port mapping etc, and hardware NAT need not 


do anything special for the features related to iptables rules because hardware NAT is 
independent of the iptables rules. 


12) won't affect alg when enable hardware nat. 
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13) total 1024 hardware nat entries, bi-direction support 512 connection. 


Note: If wan type changes to PPTP/L2TP/multi-PPPoE or URL filter/QoS function is 
enabled, hardware NAT must be manually disabled by echo correct value to "/proc/hw_nat". 


Others like ALG or IP fragment will be automatically processed, no other settings involved. 


For these hw nat limititaion, you can check the function update_hwnat_setting() in 
users/boa/system/set_firewall.c. 


4.11.4 Enable/Disable hardware NAT support 
For RTL8198, enable/disable hardware NAT support as follows: 


make linux_ menucofig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
Network device support ---> 
Options for Realtek SoC ---> 


Config for Layered Driver Features ---> 
Hardware Features Selection (Enable RTL Hardware NAPT) ---> 
/* (Default) Selected to enable hardware NAT */ 
Enable RTL Hardware NAPT 
/* Tf selected, enable hardware L2 and multicast function */ 
Enable RTL Hardware Multicast Only 
/* Tf selected, enable hardware L2 function */ 
Enable RTL Hardware switch Only 
Note: if hardware NAT is disabled, hardware QoS (refer to section 4.14) should be disabled too. 


Hardware Features Selection 
Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
<?> for additional information about this option. 


L 


4.11.5 Hardware NAT init flow 
If macro CONFIG_RTK_VLAN_SUPPORT enabled, execute the following commands after 
“echo 0 > /proc/rtk_vlan_support’. 
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Step]: 
Init hardware tables by command: 


echo -1 > /proc/hw_nat 


Step2: 
Enable hardware nat by command: 


echo | >/proc/hw_nat 


Step3: 
Configure Lan/Wan interface’s ip address 
For example: 
ifconfig brO 192.168.1.254 
Ifconfig eth! 192.168.2.100 


The linux kernel will automatically add Lan/Wan routing rules, and then sync to hardware 


routing table 


Step4: 
Configure hardware ip table by setting iptables nat rule. 
For example: 
iptables -t nat -[ POSTROUTING -o eth! -; MASQUERADE 
(or iptables -t nat -I POSTROUTING -o pppO _-j) MASQUERADE ) 


Steps: 
Configure hardware default route by command 
For example: 
route add default gw 192.168.2.200 dev eth] 
(or route add default gw 192.168.2.200 dev ppp0 ) 


Step6: 
echo | > /proc/sys/net/ipv4/ip_forward 


Allow the linux kernel to do IP packet forwarding from one network interface to another 


network interface. 


4.12 DLNA support 
Note: recommend to enable DLNA on 96D/97D/98 platform with at least 64M ram. 
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4.12.1 Linux kernel configure 
4.12.1.1 SCSI support 
Device Drivers ---> 
SCSI device support ---> 


[ ] RAID Transport Class 
{[*] SCSI device support 

[ ] legacy /proc/scsi/ support 
I Cape, 
iL 


support type (disk, CD-ROM) 


aqisk. Support 


SCS 


[al sc 
{ ] SCSI tape support 
{ ] SCSI OnStream SC-x0O tape support 
[ ] S€Si CDROM Support 

{ ] SCSI generic support 
L | Seis mech Clmyeiac Sie Sibysjerevetr| 
--- Some SCSI devices (e.g. CD jukebox) 
[ ] Probe all LUNS on each SCSI device 

[ ] Verbose SCSI error reporting (kernel size +=12K) 
IL | ‘Stefsm ikerxefejlinve; ieyeuat al ie, 

SICSE UMicsimsyorerewis| == 2; 
SCSI low-level drivers 


support multiple LUNs 


---> 


4.12.1.2 File systems configure 
File systems ---> 
DOS/FAT/NT Filesystems ---> 


] fs 

*] VFAT (Windows-95) fs support 
437) Default codepage for FAT 
iso8859-1) Default iocharset for FAT 
] NTFS file system support 


SUpPOrL 


File systems ---> 


[ XFS filesystem support 
OCFS2 file system support 
Btrfs filesystem (EXPERIMENTAL) Unstable disk format 


] 
] 
] 
] nable POSIX file locking API 
] 
] 


Inotify file change notification support 


[ 
[ 
[ 
[ 
[ 


Native Language Support ---> 


©2011 Realtek Semiconductor Corp. 


[*] Base native language support 

{iso8859-1) Default NLS Option (NEW) 

ea] Codepage 437 (United States, Canada) 

J Codepage 737 (Greek) (NEW) 

Codepage 775 (Baltic Rim) (NEW) 
Codepage 850 (Europe) (NEW) 

Codepage 852 (Central/Eastern Europe) (NEW) 

Codepage 855 (Cyrillic) (NEW) 

Codepage 857 (Turkish) (NEW) 

( 

( 

( 

( 

( 

( 

i 


Codepage 860 (Portuguese) (NEW) 
Codepage 861 (Icelandic) (NEW) 
Codepage 862 (Hebrew) (NEW) 

Codepage 863 (Canadian French) (NEW) 
Codepage 864 (Arabic) (NEW) 

Codepage 865 (Norwegian, Danish) (NEW) 
Codepage 866 (Cyrillic/Russian) (NEW) 
Codepage 869 (Greek) (NEW) 
Simplified Chinese charset (CP936, GB2312}) (NEW) 
Traditional Chinese charset (Big5) (NEW) 
Japanese charsets (Shift-JIS, EUC-JP) (NEW) 
Korean charset (CP949, EUC-KR) (NEW) 

Thai charset (CP874, TIS-620}) (NEW) 
Hebrew charsets (150-8259-8, CP1255) {NEW} 
Windows CP1250 (Slavic/Central European Languages) (NEW) 
Windows CP1251 (Bulgarian, Belarusian) (NEW) 
ASCII (United States) (NEW) 
a {Latin 1; Western European Languag } 
{Latin 2; Slavic/Central European Languages} (NEW) 

NLS ISO 8859-3 (Latin 3; Esperanto, Galician, Maltese, Turkish} (NEW) 


4.12.1.3 Enable USB support 


Linux kernel configure for USB as follows. 


make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
USB support ---> 
Support for Host-side USB // selected 

EHCI HCD (USB 2.0) support // selected 

OHCIHCD support  // selected 

USB Mass Storage support // selected 
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upport for Host-side USB 

ion USB verbose debug messages 
--— Miscellaneous USB options 
USB device filesysten| 
Enforce USB bandwidth allocation {EXPERIMENTAL} 
Dynamic USB minor allocation (EXPERIMENTAL) 

=== USB Host Controller Drivers 
BHC THe DR USheZ oe Slpport 
Full speed ISO transactions (EXPERIMENTAL) 
Root Hub Transaction Translators {EXPERIMENTAL} 


ISP116X HCD support) 
OHCI HCD support 
UHCI HCD (most Intel and VIA} support 
SL811HS HCD support 
--- USB Device Class drivers 

USB Modem (CDC ACM) support 
USB Printer support 


--- NOTE: USB STORAGE enables SCSI, and "SCSI disk support’ 
--- may also be needed; see USB STORAGE Help for more information| 


USB Mass Storage support 
USB Mass Storage verbose debug 


] 

] 

] 

] Freecom USB/ATAPI Bridge support 

] Microtech/Zio! CompactFlash/SmartMedia support 
] USBAT/USBATO2-based storage support (EXPERIMENTAL) 
] 
] 
] 
AL 


SanDisk SDDR-55 SmartMedia support (EXPERIMENTAL) 


Lexar Jumpshot Compact Flash Reader (EXPERIMENTAL) 
\ 


4.12.1.4 General setup 


General setup ---> 


Optimize for size 
Configure standard kernel features (for small systems) 
Strip assembler-generated symbols during link 


upport for hot-pluggab 
Enable support for printk 
Enable support for printk 


4.12.2 Application configure 
4.12.2.1 busybox configure 
make menuconfig and select Config busybox 
Menuconfig: 
Coreutiles---> 


df support // selected 
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Improved Transaction Translator scheduling {EXPERIMENTAL} 


Datafab Compact Flash Reader support (EXPERIMENTAL) 


SanDisk SDDR-09 {and other SmartMedia) support (EXPERIMENTAL) 
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BusyBox 1.13.4 Configuration 


4.12.2.2 enable usbmount 
make users_menuconfig // To configure application settings 
Menuconfig: 


usbmount // selected 
RLX Linux Configuration 


Ue i ie Mie emo mare) 


s 
s 


ecegccunyn 


{*] usbmount 
u 


4.12.2.3 enable dina 
make users_menuconfig // To configure application settings 
Menuconfig: 


©2011 Realtek Semiconductor Corp. 


83 


DIna_dms_ // selected 


[ ] mdadm-3.2.5 
{ ] minidina 

] ilna_dms 
J libiconv 
] miniigd 
] mini_upnp 
] mld proxy 
] 
] 
+ 


* 


rp daemon 
mt-—daapd 


4.12.3 Test dina using USB flash disk 

(1) First of all, you should read and modify /boards/rtl8 1 98/etc.default/ushare.conf. 

(2) After system boots up, plug-in an USB Flash disk. The directory to be shared is 
/var/tmp/usb/sda6/Media (you can modify this directory in ushare.conf). 

(3) Write this command: ‘ushare —f etc/ushare.conf &’ in console to enable dina as a daemon. 


(4) Then you can enjoy the multimedia in your flash disk with PS3 or XBOX and so on. 


4.13 Iptables rule to ACL rule translation support 


In order to offload cpu when firewall is enabled by iptables rules, the feature of iptables rule to 


ACL rule translation can be enabled. 
Enable iptables rule to ACL rule translation support as follows: 


make linux_ menucofig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
Network device support ---> 
Options for Realtek SoC ---> 


Enable iptables rule to RTL ACL rule // (Default) Selected 


Options for Realtek Soc 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


--- Options for Realtek Soc 
Config MIPS16-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features _--->| 
nable iptables rule to RTL ACL rule 
Enable Ethernet Private Skb 
Support HW Qos 
Enable proc filesystem for debug 
Enable rome perf| 
Support rtk vlan feature 
rtk vlan for cable mode: 
IEEE 802.115 mesh support 
Webpages in rootfs support] 


Note: if iptables rule to ACL rule is enabled, hardware NAT is recommend. 
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4.14 Hardware QoS support 
4.14.1 How to enable Hardware QoS 


In order to offload cpu when QoS is enabled, hardware QoS can be used. 


Hardware QoS is based on hardware NAT. So if we want to use hardware QoS, hardware NAT 
should be enabled at first. 


After hardware NAT (refer to section 4.12.4) is enabled, enable hardware QoS as follows: 


make linux_ menucofig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
Network device support ---> 
Options for Realtek SoC ---> 


Support HW Qos // Selected 


Options for Realtek Soc 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


<M> module < > module capable 


MMM -— options for Realtek soc] 
Config MIPS16-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features --- 
Enable iptables rule to RTL ACL rule 
Enable Ethernet Private skb 


rtk vlan for cable mode: 
IEEE 802.115 mesh support 


4.14.2 Configure HW QoS by rtk_cmd 
4.14.2.1 Function illustration 


The customer could input “rtk_cmd qos” to implement the configuration for hardware qos. 
NOTE: The function is only supported in trunk now. 
4.14.2.2 Introduction of Command 


1. ENABLE/DISABLE HW_QoS: 


Enable HW QoS, input the following command in console please: 
rtk_cmd gos Flow_Control ENABLE 
Disable HW QoS, input the following command in console please: 
rtk_cmd gos Flow_Control DISABLE 
If you want to show the flow control configure, input the following command in console please: 
rtk_cmd qos SHOW FLOW_CONTROL_CONFIG 
2. QUEUE_NUMBER: 
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Set queue number of each port, input the following command in console: 

rtk_cmd qos Queue_Num PORT_NUMI QUEUE_NUM]1 PORT_NUM2 QUEUE_NUM2... 
Input para: PORT_NUMI QUEUE_NUMI PORT_NUM2 QUEUE_NUM.2... 

Para PORT_NUM1,PORT_NUM2 mean the port you want to set ; 

Para QUEUE_NUM, QUEUE_NUM2 mean the queue number you want to use. 


e.g. if you want to use 2 queues of  port0, and use 3queues of port1, then please input the 


command in console:(please follow the format in sample) 
rtk_cmd gos Queue_Num portO 2 port! 3 
If you want to check the queue number of each port, please input the command in console : 
rtk_cmd qos SHOW QUEUE_NUMBER 
3. PRIORITY_DECISION: 


ASIC support 5 kinds of priority policy: based on port, dscp, 802.1p, acl or nat. (RTL8197F 
support an additional priority policy: based on vid, which mean 6 kinds of priority policy in total.) 
Please choose one kind policy and input the value of decision. Each decision takes up 4 bits. e.g. if 
you want to set port 15, dscp 1 802.1p2, acl3, nat 4, (vid 5), please input the following command 


in console: 
rtk_cmd qos Priority_Decision port 15 vlan I dscp 2 acl 3 nat 4 (vid 5) 
Note: The value between port and 15, vlan and 1 need a blank . 
If you want to check the priority of policies, please input the following command in console: 
rtk_cmd gos SHOW PRIORITY_DECISION 
4. PRIORITY_ASSIGN: 


Now, rtk_cmd qos support 3 kinds policy: Port_Based, Dscp_Based, 802.1 p_Based. 
(RTL8197F support an additional policy: Vid_Based, which mean 4 kinds of priority assign policy 


in total.) 
1) Port_Based: 


The priority is assigned by port. If you want to set system priority of port0= 3, system priority 
of portl=4, system priority of port2=5, please input the follow command in console: 


rtk_cmd qos Priority_Assign Port_Based portO 3 portl 4 port2 5 
2) Dscp_Based: 


The priority is assigned by dscp. If you want to set system priority=1 while dscp=10, system 
priority=2 while dscp=61, then input the follow command in console: 
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rtk_cmd qos Priority_Assign Dscp_Based dscp10 I dscp61 2 

If you want to display the priority of each dscp, please input the command in console: 
rtk_cmd gos SHOW DSCP_BASED_PRI 

3) 802.1p_Based: 


If you want to set system priority=2 while vlan priority=1, set system priority=3 while vlan 
priority=2, then please input the following command in console: 


rtk_cmd qos Priority_Assign Vlan_Based vlan1 2 vlan2 3 


If you want to check the system priority correspond to each vlan priority, please input the 


following command in console: 
rtk_cmd gos SHOW VLAN_BASED_PRI 
4) Vid_Based: 
Note: this cmd only applies to RTL8197F. 


If you want to set system priority=2 while vid priority=1, set system priority=3while vlan 
priority=2, then please input the following command in console: 


rtk_cmd qos Priority_Assign Vid_Based vid1 2 vid2 3 
5. PRIORITY_TO_QID: 


Before set the gid correspond to each system priority, please make sure that the queue number 
of each port has been set. If set priority 1 corresponding to qid 1, priority 2 corresponding to qid 2, 


please input the following command in console: 
rtk_cmd qos Priority_to_Qid pril I pri2 2 


If you want to display the mapping relationship between system priority and qid, please input 


the following command in console: 
rtk_cmd gos SHOW PRIORITY_TO_QID 
6. QUEUE_TYPE: 
Queue could be set to two types: STRICT or WEIGHTED. 
1) STRICT 


If you want to set queueO, queuel and queue2of port! to STRICT type, please input the 


following command in console: 
rtk_cmd qos Queue_Type STRICT portO gO ql q2 
If you want to check that which queues of port have been set to STRICT type, please input: 


rtk_cmd gos SHOW QUEUE_TYPE_STRICT 
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2) WEIGHTED 


If you want to set queueO of port! to WEIGHTED type, and the weight=15; set queue! to 
WEIGHTED type and weight=18, then please input the following command in console: 


rtk_cmd qos Queue_Type WEIGHTED port! q0 15 q1 18 


If you want to check which queues of port have been set to WEIGHTED type, and what the 


weight values are, then please input: 
rtk_cmd qos SHOW QUEUE_TYPE_WEIGHTED 
7. REMARK: 
ASIC support 2 kinds of remark: VLAN remark and DSCP remark. 
1) VLAN REMARK 
If you want to remark vlan priority=2 when port=0, system priority=1, please input in console: 
rtk_cmd gos Remark VLAN port0 pril 2 
If you want to check the information of vlan remark, please input in console: 
rtk_cmd gos SHOW VLAN_REMARK 
2) DSCP REMARK: 
If you want to remark dscp=61, when port=0, system priority=2, please input in console: 
rtk_cmd qos Remark DSCP porto pri2 61 
If you want to check the information of dscp remark, please input in console: 
rtk_cmd gos SHOW DSCP_REMARK 
8. QUEUE_RATE: 


If you want to set the following parameters of queue0 in portO: ppr=7, burst size=225, 


apr=16381, please input in console: 
rtk_cmd qos Rate portO gO ppr 7 burst 255 apr 16383 


If you want to check the value of ppr, burst size and apr of each queue in each port, please 


input in console: 
rtk_cmd qos SHOW QUEUE_RATE 
4.14.2.3 NOTE ITEMS 
When input the following value in console, please pay attention to the range respective: 
1. vlan priority: 3bit; 


2. system priority: 3bit; 
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3. port: 3bit; 

4. dscp value: 6bit; 
5. vid value: 12bit; 
6. weight: 7bit; 

7. ppr: 3bit; 

8. burst size: 8bit; 


9. apr: 14bit 


4.15 IPv6 support 


In order to add IPv6 support, Linux kernel, [Pv6 daemon and Busybox need to be configured. 
Note: if enable ipv6, then ipv6 passthru should be disabled and can’t be show or selected! 


4.15.1 Linux kernel for IPv6 configure 


Configure Linux kernel for IPv6 as follows: 


make linux_ menucofig // To configure linux kernel settings 
Menuconfig: 


1) Networking support ---> 
Networking options---> 
The ipv6 protocol---> —// Selected and enter 


Networking options 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


<M> module <> module capab] ce 
Oe 


IP: IPsec tunnel mode 
IP: IPsec BEET mode 
Large Receive Offload (ipv4/tcp) 
INET: socket monitoring interface 

: advanced congestion control ---> 
ption support (RFC2385) 


(EXPERIMENTAL) 


— eee ee 
= err 


] Security Marking| 
*] Network packet filtering framework (Netfilter) ---> 
The DCCP Protocol (EXPERIMENTAL) ---> 
The SCTP Protocol (EXPERIMENTAL) ---> 
The TIPC Protocol (EXPERIMENTAL) ---> 
Asynchronous Transfer Mode (ATM) 


[ 
[ 
[ 
[ 
[ 
[ 
v 


2) Networking support ---> 
Networking options---> 


The ipv6 protocol---> 
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IPv6: ready logo patch 

IPv6: Enable RFC 4429 Optimistic DAD 

IPv6: Multiple Routing Tables 

IPv6: multicast routing 

IPV6 DNS V6 MODE SUPPORT 

IPV6 RA RDNSS SUPPORT 

IPV6 RA DNSSL SUPPORT 

Realtek Fast IPV6 support 

Netfiler---> 

IPv6 netfilter configure---> 
IPv6 connection tracking support-> 
ip6tables support---> 
packet mangling---> 


packet filtering ---> 
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// Selected 
// Selected 
// Selected 
/! Selected 
// Selected 
// Selected 
//selected 


//selected 


//selected 
// Selected 
// Selected 
//Selected 


90 


Ci] IPv6: Enable RFC 4429 Optimistic DAD 


<*> IPv6 connection tracking support 


4.15.2 IPv6 daemon configure 
Configure IPv6 daemon as follows: 
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make users_ menucofig // To configure application settings 
Menuconfig: 

1) dhcpv6 // Selected 

2)dnsmasq_  //Selected 

3) dslite //selected 

4) radvd // Selected 

5) ndisc6 //Selected 


RLX Linux Configuration 


B 


Pv6 Configuration ---> 


IPv6 Configuration 


[*\] ndisc6é 


5) PPP support IPv6 //Selected 
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ia PPP Configuration ---> 


over PPP support 


6) BOA support IPv6 ~—//Selected 


7) ip6tables support //Selected 
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RLX Linux Configuration 
the menu. <Enter> selects submenus --->. Highlighted letters are hot 
jes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
xcluded <M> module < > module capable 


J 

| boa CGI Support (NEW) 
| boa IPv6 Support 

J boa new UI Support (NEW) 
}) Brett 

] busybox 

] CPU utilization 

] curl 

] curl-7.34.0 

] discover 

] dnrd 

] firmware write daemon 

] FT Daemon support 

] Gdbserver 

] Gproxy 

] hostapd 2.0 

] iapp 

] igmp proxy 

] ioh 

] iproute2 

] iptables 

] 


8) mldproxy support //Selected 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus 
-—-->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. 
(-) 


—-—-— Choose dosfstools version. 


[*] mld prox 


support mld proxy multiwan 


et ) 


9) flex library support //Selected 
Libraries Settings ---> 


[*] flex library 
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Libraries Settings 


\ 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing Y) includes, <N> excludes, <\M> modularizes features. Press <Esc><Esc> to 
exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded <M> module < > 
module capable 


[ ]_ lex library 
| 
] 
] 
] 


fuse brary 
Libpeap library 
libpng 


[ ] 
[ 
fi] 
[ ] zlib 


< Exit > < Help > 


10) 


[ma support igmp proxy multiwan 
| support igmpv3 proxy 

MLE Kelal 

[*] iproute2 

[T*] aproute2 full support 

T*] iptables  . — 

[*] ipétables 

. i Peeerspat 
[*] iproute2 


[*]  iproute2 full support 


4.15.3 Busybox for IPv6 configure 
Enter the directory of Busybox and make menuconfig to configure Busybox for IPv6 as follows: 


Menuconfig: 
1) Networking Utilities ---> 
Enable IPv6 support // Selected 


Preferentially use IPv4 addresses from DNS queries (NEW) // Selected 
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Networking Wlilities 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


(NEW) 


2) Networking Utilities ---> 


ping6 = // Selected 


Networking Utilitnes 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. 
<M> module < > module capable 
Mie. 


Legend: [*] built-in [ ] excluded 


-upport displaying rarely used link types 


4.15.4 Test IPv6 
Add IPv6 support as above and update image to our AP. 


In order to check whether IPv6 works, input command at AP console as follows: 
ifconfig brO —_// To check that ipv6 link local address of brO should exist if IPv6 works. 
4.15.5 The flash & SDRAM footprint for demo board. 
1) RTL8198 + RTL8192C 
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Enable IPv6 will lead to 262KBytes increase in flash footprint, and increase 596Kbytes in 
SDRAM footprint. 


RTL8198 + RTL8192C demo board v630 run SDK v2.5 image (2011/06/10), the test result as follows: 


Configure \  Testentry | fw.bin (KB) MemFree (KB) 
Default 1962 16420 
Enable IPv6 2224 15824 

2) RTL8196C+RTL8192D 


RTL8196C+RTL8192D demo board v400 run image (svn version: 6977 2011/08/18), the test result as 
follows: 


Configure\Test entry Root.bin(KB) | Linux.bin(KB) | fw.bin(KB) | Memfree(KB) 


Enable ipv6 1201 2203 15664 


4.16 6rd && ds-lite support 
1) add IPv6 support refer to “IPv6 support’, 


2) add 6rd & & ds-lite support: 


make linux_menuconfig 
Menuconfig: 
[*] Networking support ---> 
Networking options ---> 
<*> The IPv6 protocol = ---> 
[*] IPv6: IPv6 Rapid Deployment (6RD) 
-*_  [Pv6: IP-in-IPv6 tunnel (RFC2473) 
<*> [Pv6: GRE tunnel 
make users_menuconfig 
Menuconfig: 
IPv6 Configuration ---> 
[*] 6rd 
[*] ds-lite 


3) set ds-lite tunnel 
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set IPv6 wan 


WAN Interface Setup 


This page is used to configure the parameters for Internet network which connects to the W 
item value of WAN Access type. 


“Enable IPy6 
WAN 


Origin Type : 
WAN Link Type: | IP v| 


Static Ip 


address; rec Lent 
2oo1_|; |o2ao_|; josaf_|; foo _|: jo000_|: jooo0 |: joooo |: jooce | 64 _| 

Default Gateway: Prec Length 
2oo1_|; jo240_|; josaf_|; (foo _|: jo000_|: joooo |: joooo |: coor | 64 _| 


Dns Setting 


Configuring DNSv6 


DNS ric Lent 
2001 |: 0240 |: o6af |: foo |: 0000 |: oo0O |: \oOO0 |: Goo1 | 64 


Others 


Clone MAC Address: pooo00223212 


~~ Enable MLD Proxy 
Apply Changes | Reset | 


set IPv4 wan 
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WAN Interface Setup 


This page is used to configure the parameters for Internet network which 
may change the access method to static IP, DHCP, PPPoE, PPTP or L2TP E 


WAN Access Type:  DS-Lite 7 


— Attain AFTR Automatically 
© Set AFTR Manually 


AFTR IPv6 Address: 2001:240:63f:f01::1 


WAN IPv6 Address: 001:0240:063f: ff00:0000;0000;0000:( 


Default Gateway: 001:0240:063f:ff00:0000;0000:0000:t 


Apply Changes | Reset | 


reinit 
4) set 6rd tunnel 


set IPv4 wan 
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WAN Interface Setup 


This page is used to configure the parameters for Internet network 
may change the access method to static IP, DHCP, PPPoE, PPTP or 


WAN Access Type: Static IP v 


IP Address: 10.2.2.2 

Subnet Mask: 255,255,255,.0 

Default Gateway: 10.2.2.1 

MTU Size: 1500 (1400-1500 bytes) 
DNS 1: 10.2.2.1 
DNS 2: 
DNS 3: 


Clone MAC Address: 000000223212 


Enable uPNP 
“ Enable IGMP Proxy 
“ Enable Ping Access on WAN 

Enable Web Server Access on WAN 
“ Enable IPsec pass through on ¥PN connection 
¢ Enable PPTP pass through on ¥PN connection 
~ Enable L2TP pass through on YPN connection 


Enable IPv6 pass through on ¥PN connection 


Apply Changes | Reset | 


set IPv6 wan 
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WAN Interface Setup 


This page is used to configure the parameters for Internet network which connects to the We 
item value of WAN Access type. 


¥ Enable IPv6 
WAN 


Origin Type : 
WAN Link Type: | IP v | 


6RD 


GRD IPv6 Prefix: rec Lent 
2001_|; lodbs_|; ooo |; jaoo0 |; jaooo |: joooo |: jooo0 |: joooo | s2_| 


Dns Setting 


Configuring DNSv6 


DNS: rec Lent 
2oo1_|; 0240 |; losaf_|; |ffoo_|: joo00_|: joooo |: joooo |: ooo1 | 64 _| 


Others 


Clone MAC Address: oooo002232 12 


“ Enable MLD Proxy 


Apply Changes | Reset | 


enable radvd 

reinit 

5) Test 
ds-lite(cmd) 
route add 192.0.0.0 mask 255.255.255.0 192.168.1.254 metric 20 
ping 192.0.0.1 
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6rd(cmd) 
ping 2001 :db8:a02:201::1 


4.17 Hw 6rd && hw ds-lite support 
Hw 6rd and hw ds-lite only supported by rtl8198c and rtl8197f. 


1) First, add 6rd & & ds-lite support, refer to “6rd && ds-lite support” 
2) Second, add hw 6rd && hw ds-lite support 
make linux_menuconfig 
Menuconfig: 
Device Drivers ---> 


[*] Network device support ---> 


[*] Options for Realtek SoC ---> 


Config for Layered Driver Features ---> 
[*] Enable HW DS-LITE SUPPORT 
[*] Enable HW 6RD SUPPORT 

Device Drivers ---> 


[*] Network device support ---> 


[*] Options for Realtek SoC ---> 


[*] 


Note: when enable ipv6 software qos, must disable hardware ipv6 routing. 


Enable hardware ipv6 support 


4.18 64K/sector SPI flash support 


In order to add 64K/sector SPI flash support, both Linux kernel and Bootloader need to be 
re-configured. 


1) Linux kernel configure as follows (here we take a 64K/sector 8M SPI flash as an example): 
make linux_ menucofig // To configure linux kernel settings 


Menuconfig: 
System Configuration ---> 


(Ox800000) Size of Flash // 8M Flash 


(0x10000) Hardware setting offset in flash. 
(0x20000) Default setting offset in flash. 
(0x30000) Current setting offset in flash. 
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// user defined, but 64K alignment needed 
// user defined, but 64K alignment needed 


// user defined, but 64K alignment needed 
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(0x40000) webpages image offset in flash. // user defined, but 64K alignment needed 
(Ox100000) linux image offset in flash. // user defined, but 64K alignment needed 


(0x300000) root image offset in flash. // user defined, but 64K alignment needed 


System Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


] Enable timer adjustment support 
] Webpages in rootfs support 


0000) Size of Flash 

** Hardware setting offset,should be 4K alignment ***| 
(0x10000) Hardware setting offset in flash. 

*** Default setting offset,should be 4K alignment. *** 

*** size of default and current setting should be same. 
(0x20000) Default setting offset in flash. 

*** Current setting offset,should be 4K alignment. *** 
(0x30000) Current setting offset in flash. 

**x* Webpage image offset,should be 4K alignment. ***| 

*** size of web page is normally about 100K. *** 
(0x40000) webpages image offset in flash. 

*x*x* Linux image offset,should be 4K alignment. 

*** this offset MUST between 0x10000~0x40000. 
(0x100000) linux image offset in flash. 


2) Bootloader configure as follows (based on the Linux kernel configurations above): 


make menucofig // To configure bootloader settings 
Menuconfig: 


[*] Support Flash Mapping Customize 
/* Linux image flash offset range 0x10000 ~ 0x130000 which Bootloader will auto check 
should cover 0x100000 (Linux image offset in flash) set by Linux kernel above */ 


(10000) LINUX image flash offset start 
(130000) LINUX image flash offset end 


/* Root image flash offset range 0xE0000 ~ 0x400000 which Bootloader will auto check 
should cover 0x300000 (Root image offset in flash) set by Linux kernel above */ 


(E0000) ROOT image flash offset start 
(400000) ROOT image flash offset end 
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Arrow keys navigate the menu. 


Pressing <Y> includes, <N> excludes, <M> modularizes features. 


Target Platrorm selection 
<Enter> selects submenus --->. Highlighted letters are hotkeys. 
Press <Esc><Esc> to exit, <?> for Help. 


Legend: [*] built-in [ ] excluded <M> module < > module capable 


te 


(BOOT_SIO_8198_8196C) s SPI IO Type 

[*] PI CLCK LIMIT SPEED<40MHzZ| 

[*] PI FLASH SINGLE IO MODE(CAN ENABLE DHCP) 
(NORMAL) s SDRAM Type 

[ ] upport SC16IS?x0 I2C UART 

[*] onfig Spi Flash Number 

(1) LASH_NUMBER 

[*] upport Flash Mapping 


(130000) INUX image flash offset end 


(1000) INUX image check step 


4.19 SPI Flash Support 


4.17.1 Two SPI Flash Support 


(E0000) OOT image flash offset start 
400000) OOT image flash offset end 
(1000) OOT image check step 

-upport Flash DualBank| 

ZMA Enable (Default GZip) 
-upport DHCP Server 

-upport HTTP Update 

ower On Self Test Enable 

oot Code Debug Command Enable 
-upport reset botton feature 
-upport boot time measure 
-upport Pocket AP} 


-nable JTAG Function for code debugging 


Add two SPI flash support need to modify both bootloader configuration and Linux kernel 


configuration. 


4.17.1.1 Configure bootloader for two SPI flash support 


Enter bootloader directory and make menuconfig to configure bootloader settings as follows: 


Target Platform Selection ---> 


//Selected to add more than one SPI flash support 


[*] Config Spi Flash Number (NEW) 


/Anput number of SPI flash to support, such as 2 here 


(2) FLASH_NUMBER (NEW) 
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Target Planrorm seLection 

Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters 
are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. 
Press <Esc><Esc> to exit, <?> for Help. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 

il) 
(RTL8196C) roduct 
(Dram16M_16Mxl_16bit) s the target of HW Setting 
(SPI_FLASH) s FLASH Type 
(BOOT_SIO_8198 8196C) s SPI IO Type 
[*] PI CLCK LIMIT SPEED<40MHz 
[*] PI FLASH SINGLE IO MODE(CAN ENABLE DHCP) 
(NORMAL) s SDRAM Type 
[ ] upport SC161IS7x0 I2C UART 
[*] Config Spi Flash Number (NEW) 
(2)  LASH NUMBER (NEW) 
[*] upport Flash Mapping Customize 
(10000) INUX image flash offset start 
(40000) INUX image flash offset end 
(1000) INUX image check step 
(E0000) OOT image flash offset start 
(130000) oOoT image flash offset end 
(1000) oOoT image check step 
[ ] upport Flash DualBank| 


L v (+) 


4.17.1.2 Configure Linux kernel for two SPI flash support 


Enter Linux kernel directory and make menuconfig to configure Linux kernel settings as follows: 
System Configuration ---> 
[*] two spi flash support // Selected to add two SPI flash support 
(0x400000) Config Ist flash size (NEW) //Input the 1‘ flash size, such as 4MB here 
(0x400000) Config 2nd flash size (NEW) = ///Input the 2™ flash size, such as 4MB here 


(Ox800000) Size of Flash // Input total size of two SPI flash, such as 8MB here 
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System Configuration 
Arrow keys navigate the menu. 
are hotkeys. 
Press <Esc><Esc> to exit, <?> for Help, </> for Search. 
excluded <M> module < > module capable 


<Enter> selects submenus --->. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. 


Legend: 


Ll) doelilie aja 


[ 


iH 


Domain name query support 


(O0x400000) Config lst f 
(O0x400000) Config 2nd flash size (NEW) 

*** Wlash size 2M or 4M, default 2M *** 
(Ox800000) Size of Flash 


(Ox6000) Hardware setting offset in flash. 


(0x8000) Default setting offset in flash. 


*** Current setting offset,should be 4K alignment. *** 


(OxcO00) Current setting offset in flash. 


*x%x Webpage image offset,should be 4K alignment. *** 
*** size of web page is normally about 100K. *** 


L v (+) 


4.17.2 Add New SPI Flash (Non-RTL8197F) 


*** Hardware setting offset,should be 4K alignment *** 


*** Default setting offset,should be 4K alignment. *** 
*** size of default and current setting should be same. 


If want to add a new SPI flash, bootloader and kernel source should be modified as below 


4.17.2.1 Add New SPI Flash in bootcoder 


Find the “spi_common.c” file in bootloader, and search “struct spi_flash_known 


spi_flash_registed [] “, fill in the structure with new SPI flash’s info. The chip info can 


Get from datasheet. 


struct spi_flash_known 


unsigned int uiChipld; 

unsigned int uiDistinguish; 

unsigned int uiCapacityld; 

unsigned int uiBlockSize; 

unsigned int uiSectorSize; 

unsigned int uiPageSize; 

char* pcChipName; 

unsigned int chipClock; 
FUNC_ERASE pfErase; 
FUNC_READ pfRead; 
FUNC_SETQEBIT  pfQeBit; 


FUNC_PAGEWRITE pfPageWrite; 
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Highlighted letters 


] 
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}3 

Where “chipClock” is the frequency the SPI flash good work at. The callback functions 
Should be fill with common function used in the file if the SPI flash is generic. Maybe “pfQeBit” 
Need to be re-implemented according to NEW SPI flash’s datasheet. 
4.17.2.2 Add New SPI Flash in linux 

The same operation as done in bootloader. 


4.17.3 Add New SPI Flash (RTL8197F) 
If want to add a new SPI flash, bootloader and kernel source should be modified as below 


4.17.3.1 Add New SPI Flash in bootcoder 
Find the “m25p80.c” file in bootloader, and search “struct spi_device_id m25p_ids[]“, fill in the 


structure with new SPI flash’s info. The chip info can get from flash datasheet. 


struct flash_info { 
u32 jedec_id; 
ul6 ext_id; 


unsigned sector_size; 


ul6 n_sectors; 
ul6 page_size; 
ul6 addr_ width; 
ul6 flags; 


iE 


struct spi_device_id { 
char name[SPI_NAME_ SIZE]; 
kernel_ulong_t driver_data; /* Data private to the driver */ 


To adjust the well-work frequency of the SPI flash, you should find the “spi-sheipa.c” file in 
bootloader, and then search “spi_flash_setbaudr() & spi_flash_setfbaudr ()“ to set the proper spi_sclk 


divider value to the baud rate register. 


4.17.3.2 Add New SPI Flash in linux 
The same operation as done in bootloader. 


4.20 92C/D support 
4.18.1 92C support for Pocket AP SDK 
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1) Select SDK for Pocket AP 92C: 
Selected Target of SDK ---> 
And selected “11nPocket_Router” 


Selected Target of SDK 


<?> for additional information about this option. 


Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. 


Press 


linRouter GW 
1inPocket Router 


2) Enable 92C Driver 
Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. 


<EsSc><ESc> to exit, <?> for Help, </> for Search. Legend: [*] built-in 
<M> module < > module capable 


Highlighted letters are 


Press 
[ ] excluded 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 


wireless support 
Private skb buffer management 


4.18.2 92D support for Pocket AP SDK 

1) Select SDK for Pocket AP 92D: 
Selected Target of SDK —---> 
And selected “11nPocket_Router” 
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Selected Target of SDK 
Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
“ie ieee elelcblieafojarel ohinue(ejembeliealfoyn, flloyojble jelsul{fs) (oyeimslopel 


linRouter GW 
1inPocke t Router 


2) Enable 92D Driver 
Config kernel —---> 
Device Drivers ---> 


Network device support ---> 


Wireless LAN ---> 
Wireless LAN 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 


<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


(> _* = 2A] Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 


Realtek 8190 wireless support 
Realtek 8192SE wireless support 


=>] 


Realtek 8192C wireless support 
Private skb buffer management| 
Realtek hostapd support 

eS Client Mode Support 

Client Mode 802.1x Support 

Repeater Mode support 


+ OF 


Selected “Realtek 8192D wireless support” 
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Wireless LAN 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 


hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 


<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] 
<M> module < > module capable 


excluded 


| Wireless LAN (pre-802.11) — -> 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL8192C/D 802.11b/g/n support 
Realtek 8192D wireless support 
Private skb buffer management 


RTL8192D dual-MAC-dual-PHY mode (NEW) 


a es i 


Smart Concurrent Support (NEW) 
Support Dual card: 96C+96DI 


If “RTL8192D dual-MAC-dual-PHY mode” is selected, only supports 92Dve: 


Wireless LAN 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 


hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 


<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] 
<M> module < > module capable 


excluded 


=a) Wireless LAN (pre-802.11) — -> 
Wireless LAN (IEEE 802.11) 


Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL8192C/D 802.11b/g/n support 

Realtek 8192D wireless support 
Private skb buffer management 
RTL8192D dual-MAC-dual-PHY mode (NEW) 


Ce i a 


Smart Concurrent Support (NEW) 
Support Dual card: 96C+96D 


If “RTL8192D dual-MAC-dual-PHY mode” is canceled, supports both 92Dvs and 92Dvc: 
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Wireless LAN 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


<M> module < > module capable 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
*] RTL8192C/D 802.11b/g/n support 
* Realtek 8192D wireless support 
fa} Private _skb buffer 
8192D dual-M HY mode 
Virtual AP Support 
ss Client Mode Support| 
WDS Support| 
Efuse Support 
Smart Concurrent Support (NEW) 

Use USB Power (NEW) 
bison Ilha fetsgaccld SlCr ps Zap 


Save and Make. 
4.18.3 92D support for RTL8198 SDK 
Enable 92D Driver 
Config kernel —---> 
Device Drivers ---> 


Network device support ---> 


Wireless LAN ---> 
Enable 92D: 
Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


<M> module < > module capable 


Wireless LAN (pre-802.11) 

Wireless LAN (IEEE 802.11) 

Realtek 8190 wireless support 

Realtek 8192SE wireless support 

RTL8192C/D 802.11b/g/n support 

8198 clock source at 40Mhz 
) wirel 


(NEW) 


Smart Concurrent Support (NEW) 
Support Dual card: 96C+96D 


If “RTL8192D dual-MAC-dual-PHY mode” is selected, only supports 92Dve: 
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Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
hotkeys. Pressing <Y> includes, <N> excludes, 
<Esc><Esc> to exit, <?> for Help, </> for Search. 
<M> module < > module capable 


Legend: 


<M> modularizes features. 
[A] burlt=in fd 


Highlighted letters are 
Press 
excluded 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL8192C/D 802.11b/g/n support 
Realtek 8192D wireless support 
Private skb buffer management 
RTL8192D dual-MAC-dual-PHY mode 
Virtual AP Support| 
Client Mode Support 


=2] 


(NEW) 


a es i 


Smart Concurrent Support 
Support Dual card: 96C+96DI 


(NEW) 


If “RTL8192D dual-MAC-dual-PHY mode” is canceled, supports both 92Dvs and 92Dvc: 


Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
hotkeys. Pressing <Y> includes, <N> excludes, 
<Esc><Esc> to exit, <?> for Help, </> for Search. 
<M> module < > module capable 


Legend: 


<M> modularizes features. 
[*] built-in 


Highlighted letters are 
Press 
[ ] excluded 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
*] RTL8192C/D 802.11b/g/n support 
« Realtek 8192D wireless support 
=I 


2D dual-MA 


Smart Concurrent Support 
Use USB Power 
Support Dual card: 92C+92D 


(NEW) 


Save and make. 
4.18.4 92C support for RTL8198 SDK 
Enable 92C Driver 
Config kernel —---> 
Device Drivers ---> 
Network device support ---> 
Wireless LAN 


Enable 92C: 


aoa 
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Wireless LAN = 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
Wielexcljsioes jgle) (epee <<pe> see Inlellsy, << eons [Sletelerellain Legend: [*] built-in [ ] excluded 
<M> module < > module capable 
Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL8 (D802. lls fg/n is 
ock source at 
fe Realtek 8192C wireless support 
* Private skb buffer management 
ae 
* 
* 
* 
Enable both of the 2 pcie slot for bi-8192C support 
L v(t) 


Save and make. 
4.18.5 92C and 92D support for RTL8198 SDK 
Enable 92D Driver and 92C Driver 
Config kernel —---> 
Device Drivers ---> 
Network device support ---> 
Wireless LAN ---> 
Select “Support Dual card: 92C+92D” 


Wireless LAN 7 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


<M> module < > module capable 
She) 


Realtek 8192SE wireless support 
*] RTL8192C/D 802.11b/g/n support 
Ss 8198 clock source at 40Mhz 
a Realtek 8192C wireless support 
eg Private skb buffer management 
Realtek hostapd support 


=—*— Realtek 8192D wireless support 
Private skb buffer management 


This configuration can support both 92Dvs and 92Dvc. 


Save and make. 
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4.21 HTTP file server support 
4.19.1 HTTP File Server Introduction 


HTTP File Server is used to Brower/upload/Delete files on USB storage device which connected 
to Realtek RTL819x Wireless Home Gateway. 


4.19.2 Configuration for HTTP File Server 

1) Kernel configure for HTTP File Server 
make linux_menuconfig // To configure kernel settings 
Menuconfig: 


System Configuration ---> 


[*] Http File server support // Selected 


System Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > module 


System Type (RTL8196C Demo Board) ---> 
] Enable watchdog timer support 
] Enable timer adjustment support 
] Webpages in rootfs support 
] SPI flash support 

] Enable Flash Mapping 
] 

] 

] 

] 


Pocket router support 
Domain name query support 


ei, 
<E > sa si 
General setup ---> 
[*]Support for hot-pluggable devices // Selected 
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[*] Prompt for development and/or incomplete code/drivers 

O Local version - append to kernel release 

[ ] Automatically append version information to the version string 
] Support for paging of anonymous memory (swap) 

System V IPC 

POSIX Message Queues 

BSD Process Accounting 

Export task/process statistics through netlink (EXPERIMENTAL) 
Auditing support 

RCU Subsystem ---> 

Kernel .config support 

(12) Kernel log buffer size (16 => 64KB, 17 => 128KB) 

Group CPU scheduler 

Control Group support ---> 

Create deprecated sysfs layout for older userspace tools 
Kernel->user space relay support (formerly relayfs) 
Namespaces support 

] Initial RAM filesystem and RAM disk (initramfs/initrd) support 
[*] Optimize for size 

-*- Configure standard kernel features (for small systems) ---> 
trip assembler-generated Symbols during link 


upport for hot-pluggable 
[*] Enable support for printk Tae 
[ ] Enable support for printk console 


Device Drivers ---> 
SCSI device support ---> 
[*] SCSI device support // Selected 
[*] legacy /proc/scsi/ support (NEW) // Selected 
[*] SCSI disk support // Selected 


[*] SCSI low-level drivers (NEW) ---> // Selected 


SCSI device support 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 


Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> 


for Help, </> for Search. Legend: [*] built-in [ ] excluded <M> module 


< > module capable 


RAID Transp rt Class 


e support 

Seo target support (NEW) 
legacy /proc/scsi/ support (NEW) 
*** SCSI support type (disk, tape, CD-ROM) *** 


tape support (NEW) 
SCSI OnStream SC-x0 tape support (NEW) 
SCSI CDROM support (NEW) 
SCSI generic support (NEW) 
SCSI media changer support (NEW) 
*** Some SCSI devices (e.g. CD Jukebox) 
Probe all LUNs on each SCSI device (NEW) 
Verbose SCSI error reporting (kernel size +=12K) (NEW) 
SCSI logging facility (NEW) 
Asynchronous SCSI scanning (NEW) 
RIGEHE WNesinSjoloiaies) =e; 
SCSI low-level drivers (NEW) 
SCSI Device Handlers (NEW) 
OsD-Initiator library (NEW) 


---> 


Device Drivers ---> 


©2011 Realtek Semiconductor Corp. 


support multiple LUNs *** 


115 


[*] USB support ---> 


[*] | Support for Host-side USB // Selected 
[*] | USB device class-devices (DEPRECATED) (NEW) // Selected 
[*] USB Monitor (NEW) // Selected 
[*] | EHCI HCD (USB 2.0) support // Selected 
[*] | OHCI HCD support // Selected 
[*] | USB Mass Storage support // Selected 
USB support 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 


Pressing <Y> includes, <N> excludes, <M> modularizes features. 
Legend: 


</> for Search. 


Press <Esc><Esc> to exit, <?> for Help, 
[*] built-in [ ] excluded <M> module < > module capable 


d 5B 

USB verbose debug messages (NEW) 

USB announce new devices (NEW) 

*** Miscellaneous USB options *** 

USB device filesystem (NEW) 

USB device class-devices (DEPRECATED) (NEW) 


Dynamic USB minor allocation (NEW) 

Rely on OTG Targeted Peripherals List (NEW) 
Disable external hubs (NEW) 

USB Monitor (NEW) 


Enable Wireless USB extensions (EXPERIMENTAL) (NEW) 
Support WUSB Cable Based Association (CBA) (NEW) 
oUSBeHOsttont rollers riversmans 

Cypress C6é7x00 HCD support 


v(+) 


EHCI HCD (USB 2.0 
Root Hub Transaction Translators (NEW) 


Improved Transaction Translator scheduling (EXPERIMENTAL) (NEW) 


OXU210HP HCD support 

ISP116X HCD support ( 

ISP 1760 HCD support ( 

OHCI HCD support 

SL811HS HCD support (NEW) 

R8A66597 HCD support (NEW) 

Host Wire Adapter (HWA) driver (EXPERIMENTAL) (NEW) 
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Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


lead 
8266597 HCD support (NEW) 
Host Wire Adapter (HWA) driver (EXPERIMENTAL) (NEW) 
*** USB Device Class drivers *** 
SB Modem (CDC ACM) support (NEW) 
SB Printer support (NEW) 
SB Wireless Device Management support (NEW) 
SB Test and Measurement Class support (NEW) 
*** NOTE: USB STORAGE depends on SCSI but BLK DEV_SD may *** 
*** also be needed; see USB STORAGE Help for more info *** 


SB Mass Storage verbose debug (NEW) 
atafab Compact Flash Reader support (NEW) 
reecom USB/ATAPI Bridge support (NEW) 
SD-200 USB/ATA Bridge support (NEW) 
SBAT/USBATO2-based storage support (NEW) 
anDisk SDDR-09 (and other SmartMedia, including DPCM) 
anDisk SDDR-55 SmartMedia support (NEW) 
exar Jumpshot Compact Flash Reader (NEW) 
lympus MAUSB-10/Fuji DPC-R1l support (NEW) 
upport for Rio Karma music player (NEW) 
AT emulation on Cypress USB/ATA Bridge with ATACB (NEW) 
he shared table of common (or usual) storage devices (NEW) 
**x*x USB Imaging devices *** 
SB Mustek MDC800 Digital Camera support (NEW) 
Microtek X6USB scanner support (NEW) 


Support (NEW) 


L v(+) 


=: <exit >< Hep 


File systems ---> 
[*] Enable POSIX file locking API // Selected 


[*] FUSE (Filesystem in Userspace) support /! Selected 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> 
for Help, </> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


econd extended fs support 
xt3 jJournalling file system support 
he Extended 4 (ext4) filesyste 
eiserfs support 
FS filesystem support 
FS filesystem support 
CFS2 file system support 
trfs filesystem (EXPERIMENTAL) Unstable disk format 


E 


aches ---> 
D-ROM/DVD Filesystems ---> 
OS/FAT/NT Filesystems ---> 
seudo filesystems ---> 
[*] Miscellaneous filesystems 
[ ] Network File Systems ---> 
7 v(+) 


CG < Exit >< He]p > 


---> 
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File systems ---> 


DOS/FAT/NT Filesystems ---> 
[*] MSDOS fs support // Selected 


[*] VFAT (Windows-95) fs support // Selected 


(437) Default codepage for FAT (NEW) 


(utf8) Default iocharset for FAT  // Set Default iocharset for FAT is “utf8” 


[*] NTFS file system support // Selected, but Disable NTFS write support 


Arrow keys 


DOS/FAT/NT Filesystems 
navigate the menu. <Enter> selects submenus --->. Highlighted 


letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 


features. 


[*] built-in [ ] excluded <M> module < > module capable 


[ 


(utfs) 


rad 


File systems 


] MSDOS fs support 
[*] VFAT (Windows-95) fs support 
(437) Default codepage for FAT (NEW) 
Default iocharset for FAT 
[*] NTFS file system support 
EI NTFS debugging support (NEW) 
NTFS write support (NEW) 


Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend 


<£E > <H 
a, 
[*] Native language support ---> 
[*] | Codepage 437 (United States, Canada) // Selected 


[*] 
[*] 


NLS ISO 8859-1 (Latin 1; Western European Languages) // Selected 
NLS UTF-8 // Selected 
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Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


--- Native language support 
(iso8859-1) Default NLS Option (NEW) 


odepage (Greek) (NEW) 
odepage 775 (Baltic Rim) (NEW) 
odepage 850 (Europe) (NEW) 
odepage 852 (Central/Eastern Europe) (NEW) 
odepage 855 (Cyrillic) (NEW) 
odepage 857 (Turkish) (NEW) 
odepage 860 (Portuguese) (NEW) 
odepage 861 (Icelandic) (NEW) 
odepage 862 (Hebrew) (NEW) 
odepage 863 (Canadian French) (NEW) 
odepage 864 (Arabic) (NEW) 
odepage 865 (Norwegian, Danish) (NEW) 
odepage 866 (Cyrillic/Russian) (NEW) 
odepage 869 (Greek) (NEW) 
implified Chinese charset (CP936, GB2312) (NEW) 
raditional Chinese charset (Big5) (NEW) 
apanese charsets (Shift-JIS, EUC-JP) (NEW) 
orean charset (CP949, EUC-KR) (NEW) 
hai charset (CP874, TIS-620) (NEW) 
Hebrew charsets (I1S0-8859-8, CP1255) (NEW) 
indows CP1250 (Slavic/Central European Languages) (NEW) 
indows CP1251 (Bulgarian, Belarusian) (NEW) 


5 v(+) 

Pl <exit> <5) 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 


</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


a=) 
odepage 866 (Cyrillic/Russian) (NEW) 
odepage 869 (Greek) (NEW) 
implified Chinese charset (CP936, GB2312) (NEW) 
raditional Chinese charset (Big5) (NEW) 
apanese charsets (Shift-JIS, EUC-JP) (NEW) 
orean charset (CP949, EUC-KR) (NEW) 
hai charset (CP874, TIS-620) (NEW) 
Hebrew charsets (1S0-8859-8, CP1255) (NEW) 
indows CP1250 (Slavic/Central European Languages) (NEW) 
indows CP1251 (Bulgarian, Belarusian) (NEW) 
SCII (United States) (NEW) 


Slavic/Central European Languages) (NEW) 


8859-2 
ISO 8859-3 


(Gata 
(Latin 3; Esperanto, Galician, Maltese, Turkish) (NEW) 
Iso 8859-4 (Latin 4; old Baltic charset) (NEW) 
so 8859-5 (Cyrillic) (NEW) 
8859-6 (Arabic) (NEW) 

( 

( 

( 

( 


180) G5 59—7 Modern Greek) (NEW) 

$0 8859-9 Latin 5; Turkish) (NEW) 
SO 8859-13 (Latin 7; Baltic) (NEW) 
SO 8859-14 (Latin 8; Celtic) (NEW) 
S$ ISO 8859-15 (Latin 9; Western European Languages with Euro) (NEW) 
S KOI8-R (Russian) (NEW) 
S$ KOI8-U/RU (Ukrainian, Belarusian) (NEW) 


NMNUNMNNnMNNnMNN 
w 
° 


SZ2A2Z 22242422222 


2) Application configure for HTTP File Server 


make users_menuconfig // To configure application settings 
Menuconfig: 
[*] ntfs3g // selected 
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RLX Linux Configuration 


ile system Configuration ---> 


| File system Configuration 


[i] ntfs3qg 
ie 


[*] usbmount // selected 
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RLX Linux Configuration 


Pp 
p 
r 
Hy 
1s 
R 
18 
R 
s 
Ss 
s 
s 
s 
s 
c 
u 


[hd] sbmount 
u 


4.19.3 WEB GUI Manual 
Home page: 


Realtek uWiFi 


E scitings 


Shared Partitions: 
No shared partition available. 


The Hyperlink “Settings” is for Router configuration, and if partition is available, the partition 


° 


name will be showed in “Shared Partitions’ 


Realtek uWiFi B settings 
Shared Partitions: 
“sdal 


User can enter the hyperlink in shared partition for file access. 
User can click the hyperlink “Name”, “Last modified”, and “Size” for sort. 
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Index of /sdal 


Name Last modified Size 

Parent Directory 

(123/ 28-Oct-2010 16:07:00 - Remove 
Qabe/ 28-Oct-2010 18:18:14 - Remove 
=) 1.txt 20-Oct-2010 15:05:14 25.68K Remove 


Select File] wie... | Upload | 


4.22 Hostapd support 
Add hostapd support as follows: 


Step 1, modify the related files. 


(® users/hostapd-0.6.10/hostapd/Makefile, comment lines as follows: 


# CFLAGS += -DINBAND_CTRL 

# CFLAGS += -I../../inband_lib 

# LIBS +=../../inband_lib/inband.a 
Q) users/script/cinit/init.sh, modified as follows: 

# sysconf init $* 

echo I > /proc/rtk_vlan_support 

echo "hostapd test... " 

bretl addbr br0 

bretl addif br0 ethO 

brctl addif br0 eth2 

bretl addif br0 eth3 

bretl addif br0 eth4 

brctl addif br0O wlanO 

ifconfig brO 192.168.1.254 

ifconfig eth] 192.168.2.167 

ifconfig ethO up 

ifconfig eth2 up 


ifconfig eth3 up 
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ifconfig eth4 up 
ifconfig wlanO hw ether 00:44:55:66:98:81 
cp /etc/hostapd.* /tmp 


(3) Copy net80211 folder (linux-2.6.30/include/net80211 or linux-3.10/include/net80211) 
under include the folder of toolchain, ex: 
toolchain/rsdk-1.3.6-528 1-EB-2.6.30-0.9.30/include/net80211. 


Step 2, configure kernel and application. 


@ Select “Realtek hostapd support” at kernel menuconfig. 
Device Drivers -—--> 
Network device support —-—> 
Wireless LAN -—--> 
[*] Realtek hostapd support 


Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8130 wireless support 
Realtek 8192SE wireless support 
[*] RTL8192C/D 802.11b/g/n support 
Realtek 8192C wireless support 
Private skb buffer management 
pd support 
Client Mode Support 
Client Mode 802.1x Support| 
Repeater Mode support} 


Enable PCIE power saving support 
Realtek 8192D wireless support 
Support Dual card:96C+96D 


@2) Select “openssl” & “hostapd in host controlled mode” and disable auth & 
wsc at users menuconf ig. 
[ ] auth 
[*] openssl 
-——— Choose openssl version. 
openssl (openssl-0.9. 8b) ---> 
[*] hostapd in host controlled mode 
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[ ] wse daemon 


~ REX Linux Configuration [0 


hostapd in host controlled modefj 


Step 3, test hostapd. 


@ Test wpa2-psk 
Firstly at AP console input command as follows: 


killall hostapd 
hostapd /etc/hapd_psk.wpa2-ccmp-5g & 


Secondly wireless client connect to our AP (SSID: hostapd_2_0-wpa2-ccmp) using 


©2011 Realtek Semiconductor Corp. 124 


wpa2-psk (password: 12345678). 


@) Test WPS push button 
Firstly at AP console input command as follows: 


killall hostapd 


hostapd —B etc/hostapd_O.wps_upnp & 
hostapd_cli wps_pbc 


Secondly wireless client connect to our AP using WPS push button. 


(3) Test WPS pin 
Firstly at AP console input command as follows: 


killall hostapd 


hostapd —B etc/hostapd_O.wps_upnp & 
hostapd_cli wps_pin <uuid > <sta_pin_code> 
the uuid can be “any” or like format “63041253-1019-2006-1228-00D24C819881” 


Secondly wireless client connect to our AP using WPS pin. 


() Test wpa2-802.1x 
Firstly at AP console input command as follows: 


killall hostapd 
hostapd /tmp/hostapd.radius_wpa_test & 
Secondly wireless client connect to our AP using wpa2-802.1x 
Step 4, customize hostapd. 
If user want to customize hostapd, the configure file of hostapd at the folder of 


users/hostapd-0.6.10/hostapd/conf can be modified as user need. 


4.23 MP support 


4.21.1 RTL8196C MP support 
For RTL8196C MP, uses “make menuconfig” to configure RTL8196C SDK settings as follows. 
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RLX Linux Contiguration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. 
</> for Search. Legend: [*] built-in [ ] excluded <M> module 


Highlighted letters are hotkeys. 
Press <Esc><Esc> to exit, <?> for Help, 


< > module capable 


select components 

Selected Target (rtl18196c) ---> 

Selected Kernel (linux-2.6.30) 

Selected Busybox (busybox-1.13) 

Selected toolchain (rsdk-1.3.6-4181-EB-2.6.30-0.9.30) ---> 


Selected Target of SDK (llnRouter GW) --- 


Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


After configuring the settings as above, please refer to section 4.18 and configure the right 


wireless driver. 


4.21.2 RTL8198 MP support 
For RTL8198 MP, uses “make menuconfig” to configure RTL8198 SDK settings as follows. 
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RLX Linux Configuration 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


select components| 


Selected Kernel (linux-2.6.30) 
Selected Busybox (busybox-1.13) 
Selected toolchain (rsdk-1.3.6-5281-EB-2.6.30-0.9.30) ---> 


Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


After configuring the settings as above, please refer to section 4.18 and configure the right 


wireless driver. 


4.21.3 POCKET AP MP support 
Since POCKET AP MP is based on RTL8196C MP, POCKET AP MP configure as follows: 


Step 1, use “make menuconfig” to configure SDK settings as follows. 
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Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


select components 

elected Target (rt18196c) ---> 

elected Kernel (linux-2.6.30) 

elected Busybox (busybox-1.13) 

elected toolchain (rsdk-1.3.6-4181-EB-2.6.30-0.9.30) ---> 


oad default settings 
ave default settings| 


oad an Alternate Configuration File 
ave an Alternate Configuration File 


Step 2, use “make linux_menuconfig” to config kernel settings as follows. 


System Configuration ---> 


[*] Pocket router support // Selected 
[*] Domain name query support // Selected 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 


letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
built-in [ ] excluded <M> module < > module capable 


ial 


ystem Type (RTL8196C Demo Board) ---> 
nable watchdog timer support 

nable timer adjustment support 

ebpages in rootfs support 


[ ] Enable Flash Mapping 
a] P 


[*] Domain name query support 


[ ] Http File server support 
ct) 


ee <Exit> <H 


After configuring the settings as above, please refer to section 4.18 and configure the right 


wireless driver. 
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4.21.4 RTL8196CS (iNIC) MP support 
For RTL8196CS (iNIC) MP, uses “make menuconfig” to configure RTL8198 SDK settings as 


follows. 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <¥> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to 
exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded <M> module < > 
module capable 


select components 

Selected Target (rtl18196cs) ---> 

Selected Kernel (linux-2.6.30) ---> 

Selected Busybox (busybox-1.13) ---> 

Selected toolchain (rsdk-1.3.6-4161-EB-2.6.30-0.9.30) ---> 
rtlé196cs 

Selected Target of SDK (1inPocket_Router) ---> 


Selected Board Configuration (MP) ---> 
config components 
Config kernel 
Config users 
Config busybox 
d default settings 
Save default settings 


Load an Alternate Configuration File 


<Select> 


4.24 AP mode support 


AP mode is that our platform is used as an access point rather than a router. 


4.22.1 AP mode for Pocket APSDK 
To configure AP mode for Pocket AP SDK, please use “make menuconfig” to configure SDK 


settings as follows. 


RLX Linux Configuration 5 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


<M> module < > module capable 


--- select components 
Selected Target (rt18196c) 


---> 


Selected Kernel (linux-2.6.30) ===> 

Selected Busybox (busybox-1.13) ---—> 

Selected toolchain (rsdk-1.3.6-4181-EB-2.6.30-0. 9.30) ---> 
a> seiellsilsieie 

Selected Target of SDK (llnPocket AP) ===5) 

Selected Board Configuration (AP, SPI slash + Squash) =S=5) 


Ic Test Configuration 
config components 
Config kernel 


Load an Alternate Configuration File 
Save an Alternate Configuration File 
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4.22.2 AP mode for RTL8198 SDK 
To configure AP mode for RTL8198 SDK, please use “make menuconfig” to configure SDK 


settings as follows. 


RLX Linux Configuration 7 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are 
hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


<M> module < > module capable 


--- select components 
Selected Target (rt18198) ---> 
Selected Kernel (linux-2.6.30) ---> 
Selected Busybox (busybox-1.13) 
Selected toolchain (rsadk—l.s.0-oco LPB oon oO- Ono. oO) 


Selected Board Configuration (AP - SPI flash, 
Ic Test Configuration 
-- config components 
Config kernel 


Config busybo 
Lic fault aint s fe] 
Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


4.25 Wireless configuration file support 


The wireless driver can be configured via a configuration file each time an interface is up. 


Note: this method is different from the original method. The original method: applications use 
iwpriv to set MIBs to wireless driver. This method: after the configuration file is prepared by 


applications, the wireless driver will use the configuration file to set MIBs each time an interface is up. 
1) Kernel configuration 
Use “make linux_menuconfig” to config kernel settings as follows. 
Device Drivers ---> 
[*] Network device support ---> 
Wireless LAN ---> 


[*] | Config File support 
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Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL8192C/D 802.11b/g/n support 


Private skb buffer management 
Realtek hostapd support (NEW) 


onfig File support 
Wireless Tools v29 support (NEW) 
Enable PCIE power saving support (NEW) 
Enable external high power PA (NEW) 
Enable external LNA (NEW) 
Enable both of the 2 pcie slot for bi-8192C support (NEW) 
Realtek 8192D wireless support 
Support Dual card:92C+92D 


2) Configuration file 

Path: /etc/Wireless/RTL8192CD.dat 

Sytax: “‘wlan_interface’_‘mib_command’, e.g. wlanO_ssid=xxxx. 
Notes: 

@) Add ¥#' in front of comment lines. 

(2) Space is NOT allowed between 'wlan_interface' and 'mib_command’. 

(8) If the user needs to configure MIB values with special characters, e.g. '#', the value of 
'mib_command' MUST be quoted E.g. wlanO_ssid="#XXXXX @##$$%%" 

() 'wlan_interface': wlan interface, e.g., wlan0, wlan0-va0. However, please DO NOT configure 
WDS interfaces because WDS is configured in wlanO interface. 

©) 'mib_command': MIB commands, e.g., Ssid=xxxx, please refer to table "MIB command table" 
and table "Extended MIB command table". 

© MIB value should be also configured for each virtual interface separately. 


@ Each time an interface is up, the configuration file will be loaded. 


4.26 WPS under wireless configuration file support 
For WPS, please refer to “Realtek WPS _user_guide V1.3.pdf’ for detail explanation and usages. 


In this section, it’s described that how to use WPS when wireless configuration file is supported. For 


wireless configuration file support, please refer to section 2.24. 
1) WPS daemon (wscd) 
When the wireless configuration file is supported, wscd should also refer to the wireless 
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configuration file and the parameter of wscd should be generated based on the wireless configuration 
file. Please refer to “Realtek WPS _ user guide V1.3.pdf’ for detailed information of WPS 


parameters. 


For the command line of wscd, one example is as follows: 
wscd -start -c /var/RTL8192CD.dat -w wlan0 -fi /var/wscd-wlan0.fifo -daemon 
// /var/RTL8192CD.dat is the wireless configuration file 
2) How to save wireless profile generated 


When WPS changes from un-configured state to configured state, wscd will save the wireless 
profile to a temp file and the profile need to be written to FLASH. 


3) How to trigger PBC method 
By command line or GPIO interface as follows: 
(4) wscd -sig_pbe 
(2) wsced will read /proc/gpio in one second timer, if its value>0, wscd will do PBC method. 
4) How to trigger PIN method 
By command line as follows: 
iwpriv wlanO set_mib pin=xxxxxxxx 
Note: 
The iwcontrol tool is also needed for WPS. Please make sure the FIFO is created and opened in 


wscd, and iwcontrol use the same FIFO, otherwise wscd will hang. 


4.27 Domain name query support 
At present, the feature of domain name query is only supported for POCKET AP SDK. 
Step 1, choose POCKET AP SDK first of all. 


make menuconfig as follows. 
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RLX Linux Contiguration 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <¥> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


select components 

selected Target (rtlé196c) ---> 

Selected Kernel (linux-2.6.30) 

Selected Busybox (busybox-1.13) 

Selected toolchain (rsdk-1.3.6-4181-EB-2.6.30-0.9.30) —---> 
rt18196¢ 

Selected Target of SDK (11lnPocket_Router) --->| 

Selected Board Configuration (SPI flash + Squashfs) ---> 
Ic Test Configuration 

config components 

Config kernel 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


Step 2, choose domain name query support. 
make linux_menuconfig as follows: 
System Configuration ---> 


[*] Domain name query support 
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System Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


System Type (RTL8196C Demo Board) ---> 
*] Enable watchdog timer support] 
Enable timer adjustment support 
Webpages in rootfs support} 
*] SPI flash support 
*] Enable Flash Mapping 
Pocket router support} 
Pocket AP support 
omain | 

USB3G support 

Http File server support] 
*-% Silpport two spi flash y<*4 


**%* Flash size 2M or 4M, default 2M *** 
(0x200000) Size of Flash 
*** Hardware setting offset,should be 4K alignment *** 
(0x6000) Hardware setting offset in flash. 
*** Default setting offset,should be 4K alignment. *** 
*** size of default and current setting should be same. *** 
(Ox8000) Default setting offset in flash. 
*** Current setting offset,should be 4K alignment. *** 
(OxcO00) Current setting offset in flash. 
**xx Webpage image offset,should be 4K alignment. *** 
**x*x size of web page is normally about 100K. *** 
(0x10000) webpages image offset in flash. 


z v(+) 


Step 3, test domain name query. 

1) Set Domain Name (for example: Realtek) at [LAN Interface] webpage of AP; 

2) If AP works at AP mode, AP webpage can be accessed via http://realtekap.com/home.asp 
3) If AP works at client mode, AP webpage can be accessed via http://realtekcl.com/home.asp 
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Fy Realtek WLAN AP Webserver — Microsoft Internet Explorer 
RHO) $480) Bev) wea) TA) Feo 


Oxz-O© WAG Psekmw OC eSaVTae 


Hitt (D) | @) netp: //192. 168. 1. 254/ 


[- [2 
a 


v| E)#5) we ” 


Google ||G'v vVitho @ Ey By BERR c+ WHSeA ~ Fi Me ~ (> REBW O8e~ 
7 ° 
WLAN Access Point 
LAN Interface Setup 
This page is used to configure the parameters for local area network 
which connects to the LAN port of your Access Point. Here you may 
change the setting for IP addresss, subnet mask, DHCP, etc.. 
IP Address: 192.168.1.254 
Subnet Mask: 255.255.255.0 
Default Gateway: 0.0.0.0 
DHCP: Auto v 
DHCP Client Range: 192.166.1.100 | — /192.168.1.200 Show Client 
Static DHCP: Set Static DHCP 
ave 1d Spanning ‘Disabled al 
ree: 
Clone WAC Address: [000000000000 
Apply Changes Reset 
@® Internet 
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EY Realtek WLAN AP Webserver — Microsoft Internet Explorer - [||| 


NA) 48) Bev) wea) TA) eo ae 
On-O HAO lm xem ©) 2-2BL8R8 


Google |iG- Vio SD B~ te Sete d PHeRS - 3) mz ~ g RER~ Que 


LAN Interface Setup 


This page is used to configure the parameters for local area network 
which connects to the LAN port of your Access Point. Here you may 
change the setting for IP addresss, subnet mask, DHCP, etc.. 


IP Address: 


Subnet Mask: 


Static DHCP: 


192.168.1.254 


255.255.255.0 


Default Gateway: 0.0.0.0 
DHCP: Auto v 
DHCP Client Range: (192.168.1100 | — 192.168.1.200 Show Client 


Set Static DHCP 


Domain Hane: Realtek 

802. 1d Spanning Disabled v 

Tree: 

Clone MAC Address: (00000000000 
Apply Changes | [ Reset | 


@® Internet 
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y Realtek WLAN AP Webserver — Microsoft Internet Explorer 


THe) #8) SEo) wea) Tam) FeO a 
On-O RAO le tem © 82-S5008 
Hitt @) @http:/f/realtekel. com/home. asp | > Ez ik > 
Google|G~ VFO OES > w 8B- BEMe st “ese ~ 2! me ~|(e HEB QeE- 
WLAN Access Point 
Wireless Basic Settings —wlanl a 


This page is used to configure the parameters for wireless LAN clients 
which may connect to your Access Point. Here you may change wireless 
encryption settings as well as wireless network parameters. 


(1 Disable Wireless LAN Interface 


Band: 5 GHz (A+N) v 
Node: 

dule 
Network Type: Infrastructure v 
SSID: RTK11n AP 5G 


Channel ¥Width: 


Control 
Sideband: 


Channel Humber: 


Broadcast SSID: Enabled v 


VEE: 

Data Rate: Auto ¥ 

Associated 

Clients: 
< > Oo Enable Mac Clone (Single Ethernet Client) v 
ez = : = . = a ~ a @ Internet 


4.28 rtk_voip support 
rtk_voip is only available in RTL8954C. Please refer to VoIP SDK Manual for more detail. 


4.29 Realtek Flash Dual Image support 


This feature supports two kinds of mode, static mode and toggle mode. Static mode is the default 


dual image mode. 


4.29.1 Static mode 
@ Dual image logistic 


* System always boots from bank1 if it was not corrupt. 


* Image will be backup from bank2 to bank! if bank! was corrupt, then system will boot up 
from bank1. 


* Firmware will always be written to bank! when be upgraded in bootmode mode via tftp or on 
upgrade firmware UI. 


@ Bootcode menuconfig 
please run 'menuconfig' in boot loader root directory, and then select dual image support as 
follow: 
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[*] Support Flash DualBank 
(Static) Mode 
(400000) Second Bank offset 
Please note, you may need modify Second Bank offset according to your hardware platform. 


@ 2nd bank image generate 
You must make sure the image in 2nd bank has been updated correctly before testing this 


function. You may use the following commands in boot loaderconsole to read flash from bank1, 
and write to bank2 in first time as: 


flr 80800000 30000 3d0000 
flw 430000 80800000 3d0000 


Above commands is assumed the offset of Linux image is put at Flash 0x30000, and your 
the total flash size is 8M bytes (each bank size is 4M bytes). 


If your bootcode startup from nand flash, 2nd bank image will auto burn to nand flash, so 
this step does not require. 


4.29.2 Toggle mode 
@ Dual image logistic 
* System will boot up from bank2, if bank1 is corrupted during system is booted up. 


* ~=Firmware will always be written to active bank when upgrade firmware in bootmode via tftp 
or on upgrade firmware UI when unselect "Enable Dual Firmware". 


* System will toggle the bank in each time firmware upgrade through web when select "Enable 
Dual Firmware" on upgrade firmware UI. 


* System will always boot up from the upgrade bank. 


@ Bootcode menuconfig 


please run 'menuconfig' in boot loader root directory, and then select dual image support as 
follow: 


[*] Support Flash DualBank 
(Toggle) Mode 
(400000) Second Bank offset 
Please note, you may need modify Second Bank offset according to your hardware platform 


@ Kernel menuconfig 
In order to enable the Dual Image support, you need to select the item "Enable Flash Dual Bank 


support" and enter offset of the second bank in the menuconfig. For example, you have a 8M flash 
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and want to put the first 4M to bank! and the last 4M to bank2, then you need to configure the linux 
menuconfig as follows: 
System Configuration ---> 
[*]Enable Flash Dual Bank support 
[*] | Enable Flash Dual Bank Webpage Backup Support 
**«* Second Bank Offset *** 
(0x400000) offset of Flash 
[*] Enable Flash Mapping 
*** Flash size 2M or 4M, default 2M *** 
(Ox800000) Size of Flash 
*** Hardware setting offset should be 4K alignment *** 
(0Ox6000) Hardware setting offset in flash. 
Note: even though the real flash size is 8M, the item "Size of Flash" you need to enter is 4M 
(Because the item means "Size of Bank" in Dual Image case.) 
@ Web pages 
There are some options will be added in the "Upgrade Firmware" web page if you are running a 
"Dual Image" supported firmware. You can Enable/Disable Dual Image support or reboot from the 
backup bank in web page. 
@ Howto specify dual image rootfs backup partition 
If you want to use /dev/mtdblockx as rootfs backup partition,please add “root2=/dev/mtdblockx” 
option in CONFIG_CMDLINE config 


4.30 IEEE 802.3az EEE (Energy Efficient Ethernet) support 

RTL8196C/RTL8198 support the IEEE 802.3az Energy Efficient Ethernet. This feature is enabled 
in RTL8196C and RTL8198 by default and can not be modified by end users. However, customers can 
disable this feature via linux menuconfig and the menuconfig is shown as follows: 

make menuconfig: 

-> Config kernel 

-> Device Drivers 
-> Network device support 
-> Options for Realtek SoC 
-> Disable 802.3az EEE feature 
Verification: 

The link partner needs also support EEE feature when does the verification. If such kind of link 
partner can not be found, the RTL8196C/RTL8198 can be used instead. Please connect a current meter 
to measure the DUT's current first. The DUT's current consumption will be different for EEE enabled 
image (current consumption value is lower) and EEE disable image (current consumption value is 


higher) when we plug in a RJ45 cable which connect to an EEE enabled link partner. 
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4.31 IGMP/MLD support 


4.29.1 IGMP/MLD introduce 
For IGMP support, note as follows: 


IGMP proxy supports IGMP v1/v2/v3, 
IGMP snooping supports IGMP v1/v2/v3, 
MLD snooping supports MLD v1/v2, 
IGMP/MLD snooping supports fast leave, 
Support 128 hardware multicast entries. 


IGMP proxy is independent with IGMP snooping, but hardware multicast depends on IGMP 


snooping. 


4.29.2 How to enable IGMP proxy 


make users_menuconfig //To configure applications 


Note: if only “igmp proxy” is selected, IGMPv2 is supported; if both “igmp proxy” and “support 


igmpv3 proxy” are selected, IGMPv3 is supported. 


RLX Linux Configuration 
the menu. <Enter> selects submenus --->. Highlighted letters are hot 
des, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
xcluded <M> module < > module capable 


——= — 
[*] firmware write daemon 
[ ] FT Daemon support 
[*] gdbserver 
{[ ] gproxy 
{ ] hostapd 2.0 
[ ] iapp 
(*] igmp proxy 
[*] Support igmp proxy multiwan 
[ha] support igmpv3 pro 


a . na 


4.29.3 How to enable IGMP/MLD snooping 
vim linux-2.6.30/drivers/net/rtl819x/Kconfig (or linux-3.10/drivers/et/rtl8 1 9x/Kconfig ) 


Default IGMP/MLD snooping is enabled. 


RTL_IGMP_SNOOPING 


RTL_MLD_ SNOOPING 


RTL_IGMP_SNOOPING 
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4.29.4 How to enable hardware multicast 


make linux_menuconfig //To configure linux kernel 
Linux kernel menu as follows: 
Device Drivers ---> 
[*] Network device support ---> 
[*] | Options for Realtek SoC ---> 
Config for Layered Driver Features ---> 
Hardware Features Selection (Enable RTL Hardware Multicast Only) 


Or Hardware Features Selection (Enable RTL Hardware NAPT) 


4.32 SNMP support 
4.30.1 Applications configure 


make users_menuconfig //To configure applications 


4.30.2 Kernel configure 
1) make linux_menuconfig //To configure linux kernel 

Linux kernel menu as follows: 

General setup ---> 

[*] System V IPC 

2) #define SUPPORT_SNMP_MIB at file drivers/net/wireless/rtl8 192cd/8192cd_cfg.h 
4.30.3 Webpage setting 

After load image, please set SNMP in webpage to enable SNMP. 


©2011 Realtek Semiconductor Corp. 


141 


WLAN Access Point 


SNMP Setting 


SNMP is a application for network managment 


Enable SHEP 


Name : Realtek 
Location : AP 
Contanct : Router 
Read/¥rite 
Conmaunity : private 
beetonly at 


Note: The Read/Write community and Read-Only Community Should NOT be the same 
4.30.4 SNMP test 
Rebuild image, upload image, and use MIBBROWSER to test. 


4.33 UVC support 


To support UVC (USB VIDEO CLASS), support USB first (refer to section 4.2). 
(1) If UVC is not supported, linux kernel configure for UVC as follows. 


make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
Multimedia devices ---> 


[ ] Video For Linux // Not selected 
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Multimedia devices 
Arrow keys navigate the menu. <Enter> selects submenus --—>. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


BES i ia_core support *** 
[] Video For Linux 


fy DVB for Linux 
*** Multimedia drivers *** 
[ ] DAB adapters 


<KSelect> < Exit > < Help > 


(2)If UTC is supported, linux kernel configure for UVC as follows. 
make linux_menuconfig // To configure linux kernel settings 
Menuconfig: 
Device Drivers ---> 
Multimedia devices ---> 


[*] Video For Linux _/// selected 
[*] Video capture adapters --->//selected and enter 
[*] | V4L USB devices --->//selected and enter 
[*] | USB Video Class (UVC) //selected 


V4L USB devices 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


--- V4L USB devices 

Ls] USB Video Class (UVC) 

[x] GSPCA based webcams ---> 

Hauppauge HD PVR support 

USB 3com HomeConnect (aka vicam) support (EXPERIMENTAL) 
USB IBM (Xirlink) C-it Camera support 

USB Konica Webcam support 

USB Logitech Quickcam Messenger 

USB ET61X[12]51 PC Camera Controller support 

USB OV511 Camera support 

USB SE401 Camera support 

USB SN9C1xx PC Camera Controller support 

USB STV680 (Pencam) Camera support 

USB ZCO301[P] Image Processor and Control Chip support 
L USB Philips Cameras 

* USB Philips Cameras input events device support 


pe ee 


ae 


KSelect> GE > < Help > 
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4.34 Telnetd and Login support in busybox 


Enter the busybox menu, and then make menuconfig. 
make menuconfig —_// To configure bootloader settings 


4.34.1 telnetd support menuconfig: 
menuconfig: 


Networking Utilities---> 
[*] telnetd // selected 


[*] Support standalone telnetd (not inetd only) __// selected 


Networking Utilities 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 


features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. 
[*] built-in [ ] excluded <M> module < > module capable 
th 


n- 


h tstat 
n lookup 
eB ete} 
nable fancy ping output 


scan 

oute 

lattach 

elnet 

elnetd 

Support standalone telnetd (not inetd only) 

fl) fp 
[, i] taneysrel 
W(t) 


oP < Help > 


## select items in menuconfig: 
make menuconfig 
-> Config busybox 
-> Networking Utilities ---> 
[*] telnetd 
[*] Support standalone telnetd (not inetd only) 
-> Login/Password Management Utilities ---> 
[*] adduser 
[*] login 
[*] passwd 
[*] Check new passwords for weakness 
## update files: 
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Legend: 


144 


In /boards/rtlxxxx/Makefile, add: 
$(ROMFSINST) etc/passwd /etc/passwd_orig 
$(ROMFSINST) etc/group /etc/group_orig 
$(ROMFSINST) -s /var/passwd /etc/passwd 
$(ROMFSINST) -s /var/group /etc/group 


In /boards/rtlxxxx/etc.default/passwd, add: 
root: :0:0:root:/:/bin/sh 
nobody:x:0:0:nobody:/:/dev/null 


in /boards/rtlxxxx/etc.default/init.d/rcS, add: 
cp /etc/passwd_orig /var/passwd 
cp /etc/group_orig /var/group 
telnetd& 


## after the new image upgraded, you can use a LAN PC to telnet 192.168.1.254 with login name 


“root” and without password. 


## you can use console command “adduser xxx” and “passwd xxx” to add a user for telnet login 


account. 


4.34.2 login support menuconfig 

menuconfig: 

(1) Login/Password Management Utilities---> 
[*] login // selected 
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Login/Password Management Utilities 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 


features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. 
[*] built-in [ ] excluded <M> module < > module capable 


upport for shadow passwords 


se internal DES and MDS crypt functions 
_ddgroup 
_elgroup 
_dduser 
eluser 
etty 
-upport utmp file (NEW) 
—upport wtmp file (NEW) 
-upport for PAM (Pluggable Authentication Modules) (NEW) 
-upport for login scripts (NEW) 


[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 


= ee ee ee ee 


= 
Ba 

ees 
~ 


(2) Login/Password Management Utilities---> 
[*] passwd // selected 


[*]Check new passwords for weakness //selected 


Login/Password Management Utilities 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 


features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. 
{*] built-in [ ] excluded <M> module < > module capable 


upport for shadow passwords 


se internal password and group functions rather than system function 


] 

] 

] se internal DES and MDS crypt functions 
] ddgroup 

] elgroup 

] dduser 

] eluser 

] etty 

IL Beeve ping 


[*] heck new passwords for weakness (NEW) 
[ ] ryptpw 

[ ] hpasswd 

vi(+) 


4.35 Dynamic Frequency Selection (DFS) support 
1) kernel configure 
make linux_menuconfig //To configure linux kernel 
Linux kernel menu as follows: 
Device Drivers ---> //enter 


[*]Network device support ---> //selected and enter 
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se internal password and group functions rather than system function 


146 


Wireless LAN ---> //enter 


[*]RTL8192C/D 802.11b/g/n support //selected 
[*]Realtek 8192D wireless support //selected 
[*]DFS Support //selected 


Wireless LAN 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 


features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. 
[*] built-in [ ] excluded <M> module < > module capable 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL8192C/D 802.11b/g/n support 
Realtek 8192D wireless support 
RTL8192D dual-MAC-dual-PHY mode (NET) 
Use USB Power (NEW) 
DFS Support 
Support Dual card: 92C+92D 
Private skb buffer management 
Virtual AP Support 
Client Mode Support 
Repeater Mode support 
Client Mode 802.1x Support 
WDS Support 
[ ] Efuse Support 
acd aa) | 


Select> < Exit > < Help > 


2) To obey regulation, DFS channels can ONLY be selected by auto-channel selection. The user can 


see “Auto (DFS)” on the channel column on web UI.. 
web UI menu as follows: 
Wireless ---> 
Basic Settings ---> 
Channel Number ---> 
Auto (DFS)  //selected 
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ay Windows Live 


- ie TARE ome RR A oy HE OA Ey aR ra 


WLAN Access Point 


Wireless Basic Settings —wlanl 


This page is used to configure the parameters for wireless LAN clients 
which may connect to your Access Point. Here you may change wireless 
encryption settings as well as wireless network parameters. 


[] Disable Wireless LAN Interface 
Band: ‘5 GHz (AH) 64 
Node: AP v 

Network Type: 

SSID: RIK lin AP 5G 


Channel ¥Width: 40MHz v 
Control 


Sideband: 

Channel Nusmber: [Auto (DFS) | v 
Broadcast SSID: Enabled v/| 
VEE: 

Data Rate: Auto v 


Multiple AP 


BOstEHNGH [ Show Active Clients ] 
Clients: 
Enable Mac Clone (Single Ethernet Client) 


O Enable Universal Repeater Node (Acting as AP and client 


simultaneouly) 


SSID of Extended Interface: 


fl UAD 6. tenn sans neat I oo 


3) If the user want to force the DUT set ina DFS channel for evaluation purpose, one should set 
console command with “flash set WLANO CHANNEL <channel #>’’, and then reboot. 
Note: Alternatively, the user can use http://192.168.1.254/syscmd.asp to input the command. 


5G Channel Plan 


regulation domain 


(mib regdomain value) 


supported channels — DFS enabled 


supported channels — DFS disabled 


FCC (1) 


36,40,44,48,52,56,60,64, 100,104,108, 
112,116, 136,140,149, 153,157,161,165 


36,40,44,48, 149,153, 157,161,165 


IC (2) 36,40,44,48,52,56,60,64, 149,153,157, 36,40,44,48, 149, 153,157,161 
161 

ETSI (3) 36,40,44,48,52,56,60,64, 100,104,108, 36,40,44,48 
112,116,120,124,128,132,136,140 

SPAIN (4) 36,40,44,48,52,56,60,64, 100, 104,108, 36,40,44,48 
112,116,120,124,128,132,136,140 

FRANCE (5) 36,40,44,48,52,56,60,64, 100,104,108, 36,40,44,48 
112,116,120,124,128,132,136,140 

MKK (6) 36,40,44,48,52,56,60,64, 100, 104,108, 36,40,44,48 
112,116,120,124,128,132,136,140 

ISREAL (7) 36,40,44,48,52,56,60,64, 100,104,108, 36,40,44,48 
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112,116,120,124,128,132,136,140 


MKKI1 (8) 34,38,42,46 34,38,42,46 
MKkK2 (9) 36,40,44,48 36,40,44,48 
MKK3 (10) 36,40,44,48,52,56,60,64 36,40,44,48 
NCC (11) 56,60,64, 100,104,108, 112,116,136,140, | 56,60,64,149,153,157,161,165 


149,153,157,161,165 


4.36 Fastpath Filter 


4.34.1 what’s Fastpath Filter 
‘rtk_cmd filter’ is a administration tool for IPv4 packet filtering and NAT. Fastpath filter(rtk_cmd 
filter) is used to set up, maintain, and inspect the packet filter rules before fastpath in Realtek SDK. 


4.34.2 How to enable/disable Fastpath Filter feature 
Rtk_cmd feature is the basic feature, so rtk_cmd must be enabled if you want enable fastpath 
filter. Users use rtk_cmd to add fastpath filter rules. 


1 ) Enable rtk_cmd support 


make users_menuconfig 
[*] rtk_cmd daemon 


RLX Linux Configuration 
the menu. <Enter> selects submenus --->. Highlighted letters are hot. 
les, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
‘cluded <M> module < > module capable 


= >, 

{ ] pmc utils 

{ ] python support 
[ ] reload 


[ind | tk_cmd daemor 


RTK tcp2dev utility 
ele elietvorp 


2) Enable fast filter support 


make linux_menuconfig 
Device Drivers ---> 
[*] Network device support ---> 
[*] | Options for Realtek SoC ---> 


[*] | Enable realtek fast filter 
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Uptions TOr Realtek sou 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


I--- Options for Realtek SoC 
Config MIPS16-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features --->| 
Enable iptables rule to RTL ACL rule 
realtek f 
Ethernet 
proc filesystem for debug 
rome perf 
Support rtk vlan feature 


Disable 802.3az EEE feature 


4.34.3 How to use Fastpath Filter 
1 ) Fastpath Filter Rule Format 
Realtek fastpath filter rule format is: 


rtk_cmd filter action filter_rule_option 
@ action: 
M add //addrule 
M@ delete //delete rule 
@ flush //flush filter table, clean all rules 
M@ = enableLog // enable log 
M@ disableLog //disable log 
m@ show 
@ = filter_rule_option: 
m = [--mac-src mac[/mask]] 


@ Source Mac or Mac mask; MAC format:xx:xx:xxX:XX:XX!XX OF 
FF/xx:FF/xx:FF/xx:FF/xx:FF/xx:FF/xx, the default mask is FF: FF: FF: FF:FF:FF 


| [--mac-dst mac[/mask]] 


@ = destination Mac or Mac mask; MAC format:xx:xx:xx:XX!XX!XX OF 
FF/xx:FF/xx:FF/xx:FF/xx:FF/xx:FF/xx, the default mask is FF: FF: FF:FF:FF:FF 
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mM =[--mac-range-src smac/emac] 

@ source mac range, XX:XX:XX!XX!XX!XX/XX!XX!XX!XXIXXIXX 
mM  =[--mac-range-dst smac/emac] 

@ destination mac range, xx:XX:XX!XX!XX!XX/KX!XX:XX!XX!XX:!XX 
|_| [--ip-src ip[/mask]] 


@ source IP; IP format, 192.168.1.0/255.255.255.0, the default mask is 
255.255.255.255 


|_| [--ip-dst ip[/mask]] 


@ Destination IP; IP format, 192.168.1.0/255.255.255.0, the default mask is 
255.255.255.255 


m ([--ip-range-src sip:eip] 
@ Source IP range 

m [--ip-range-dst sip:eip] 
@ Destination IP range 

m = [--port-sre port] 
@ Source port 

m ~=[--port-dst port] 
@ Destination port 

@ [--port-range-src sport:eport] 
@ Source port range 

m ~=[--port-range-dst sport:eport] 
@ Destination port range 


m = [--protocol tcp/udp/tcp_udp] 


@ protocol 

m  [--schedule day_mask:all_hours[:stime:etime]] 
@ day_mask is a char 

m= [--url-key key_word] 
@ urlorkey word 

m  =[--phy-port-source port_mask] 
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@ Physical port 
m =s[--priority priority] 

@ Priority;0~7, 0 is the highest priority, the default priority is 6 
m@  [--mark mark_value] 

@ Mark value 
@ = [--policy drop/fastpath/linux_protocol_stack/mark/omit] 


@ The action if this rule is matched, the default action is drop. 


2) Example 


Filter destination mac address “00:e0:4¢:11:22:55” 

rtk_cmd filter add --mac-dst 00:e0:4c:11:22:55 

Filter source mac address “00:e0:4¢:11:22:55” 

rtk_cmd filter add --mac-src 00:e0:4¢:11:22:55 

Filter destination mac address range, between “00:E0:4C:11:22:34” and “00:E0:4C:11:22:44” 
rtk_cmd filter add --mac-range-sre 00:E0:4C:11:22:34/00:E0:4C:11:22:44 
Filter key/url “www.biadu.com” 

rtk_cmd filter add --url-key www.biadu.com 

Filter source ip “192.168.1.100” 

rtk_cmd filter add --ip-src 192.168.1.100 

Filter destination ip “192.168.1.100” 

rtk_cmd filter add --ip-dst 192.168.1.100 

Filter source ip range, between “192.168.1.10” and “192.168.1.20” 
rtk_cmd filter add --ip-range-sre 192.168.1.10:192.168.1.20 

Filter source port “10398” 

rtk_cmd filter add --port-src 10398 

Filter destination port “10398” 

rtk_cmd filter add --port-dst 10398 

Filter source port range, between “10397” and “10399” 

rtk_cmd filter add --port-range-src 10397:10399 


Filter protocol tcp and udp 
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rtk_cmd filter add --protocol tcp_udp 


@ Physical port 5’ 


rtk_cmd filter add --phy-port-source 5 --priority 3 --mark 12 --policy mark 


s packet need add mark 12, and this rule priority is 3 


4.37 Fastpath SPI (stateful packet inspection) support 
4.35.1 What’s Fastpath SPI? 


SPI (stateful packet inspection): Do packet filter by checking ACK and sequence fields of TCP 


packets to avoid attacks. Please refer the function tcp_in_window ( ) in kernel ipv4 module for detail. 


4.35.2 How to enable/disable Fastpath SPI feature 


It is base on based on Realtek fastpath and is disabled by default setting. 


make linux_ menucofig // To configure linux kernel settings 


Menuconfig: 


Networking support ---> 


Networking options ---> 
[*] | Realtek IPTables Fast Path 


[*] 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


Realtek Fastpath SPI (stateful packet inspection) support 


Networking options 


Press <Esc><Esc> to exit, <?> for Help, 


[* 


[* 


a* Realtek Fastpath SPI (stateful packet inspection) support 


oF 


en 


(+) 


Packet socket 
Packet socket: mmapped IO 
Unix domain sockets 
PF_KEY sockets 
TCP/IP networking 
IP: multicasting 
IP: advanced router 
Realtek IPTables Fast Path 


IP: kernel level autoconfiguration 
IP: tunneling 
IP: GRE tunnels over IP 
IP: multicast routing 
IP: PIM-SM version 1 support 
IP: PIM-SM version 2 support 
IP: ARP daemon support (EXPERIMENTAL) 
IP: TCP syncookie support {disabled per default) 
IP: AH transformation 
IP: ESP transformation 
IP: IPComp transformation 
IP: IPsec transport mode 
IP: IPsec tunnel mode 
IP: IPsec BEET mode 
Large Receive Offload (ipv4/tcp) 
INET: socket monitoring interface 
TCP: advanced congestion control ---> 


< Exit > < Help > 


4.38 ALSA support 


4.36.1 What’s ALSA 
The Advanced Linux Sound Architecture (ALSA) provides audio and MIDI functionality to the 
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Linux operating system. 


4.36.2 How to enable/disable ALSA feature 
First, Enable USB support (see section 4.2). 


Then, do 


make linux_ menucofig // To configure linux kernel settings 


Menuconfig: 


Device Drivers ---> 


<*> Sound card support ---> 
<*> Advanced Linux Sound Architecture ---> 


il 


[*] 


Sequencer support 

[*] Sequencer dummy client 

OSS Mixer API 

OSS PCM (digital audio) API - Include plugin system 
OSS Sequencer API 

Support old ALSA API 

Verbose procfs contents 

Verbose printk 

Generic sound devices ---> 

<*> MOTU MidiTimePiece AV multiport MIDI 
<*> UART16550 serial MIDI driver 

<*> Generic MPU-401 UART driver 

USB sound devices ---> 

<*> USB Audio/MIDI driver 

<*> Native Instruments USB audio devices 
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Advanced Linux Sound Architecture 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> 
excludes, <M> modularizes features. Press <Esc><Esc> to exit, 
<?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 


--- Advanced Linux Sound Architecture 
Sequencer support 
Sequencer dummy client 
OSS Mixer API 
OSS PCM (digital audio) API 
OSS PCM (digital audio) API - Include plugin system 
OSS Sequencer API 
Dynamic device file minor numbers (NEW) 
Support old ALSA API (NEW) 
Verbose procfs contents (NEW) 
Verbose printk 


fen Debug (NEW) 

[es] eneric sound devices (NEW) -———> 
MIPS sound devices (NEW) ---> 
USB sound devices ---> 


ALSA for SoC audio support (NEW) ---> 


<Select> < Exit > < Help > 


Then, do cat test.wav > /dev/dsp on console will hear the voice. 


4.39 Romeperf support 
4.37.1 What’s romeperf 


Romeperf function could use to count the number of a function be called (totalNum) , average 


cycle(Average) and total(accCyle) cycle in statistics. 


4.37.2 How to enable/disable romeperf feature 


make linux_menuconfig 
-> Device Drivers 
-> Network device support (NETDEVICES [=y]) 
-> Options for Realtek SoC (RTL_819X_SWCORE [=y]) 


->[*] | Enable rome perf 
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Options for Realtek Soc 


Cea] Enable rome perf| 
s 
is 


4.37.3 How to use romeperf 


1) 


2) 


3) 


Input the index corresponding to the function for test in rtl8651_romeperflnit 


(path:drivers/net/rtl8 1 9x/romeperf.c). For example: 
romePerfStat[S9].desc = " ip_finish_output3 " 


The function ip_finish_output3 correspond to index 89 in global array romePerfStat. 


Call rtl8651_romeperfEnterPoint (89) in the beginning of function ip_finish_output3 and call 
rtl8651_romeperfExitPoint (89) in the ending of function ip_finish_output3. Note that the 


parameter 89 is corresponding to the index value 89 in function rtl8651_romeperfInit 
After the system initiation, input the command in console: 

echo FLAG] FLAG2 > /proc/rtl865x/perf_dump 
For example: 


echo 89 89 > /proc/rtlS65x/perf_dump 


The information of index=89 will be dumped: 


index description accCycle totalNum Average 
[89] ip_finish_output3 2001104 135. 14822 
231705 135 1716 
30048 135 222 
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1308804 LSS 9694 


Note: 
FLAGI in Echo command indicate the start index, and FLAG2 indicate the end index. 


If you want to dump the romeperf information of index between 79 and 89, please input: 


echo 79 89 > /proc/rtlS65x/perf_dump. 
Besides, input the following command: 
echo flush > /proc/rtl865x/perf_dump 


And the romeperf will be reset. 
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4.40 Boa support 


This section describes Boa supported features and some useful programming information, which are 


helpful to develop your own Boa web server. 


4.38.1 How to enable Boa web server on the Realtek SDK 
1) On the top directory of SDK, execute “make menuconfig” or “make config”. 


$ make menuconfig 


2) The configuration menu is shown as follows. 


Select "Config kernel" and "Config users", and then Exit the menuconfig. 
--- select components 
Selected Target (rtl8196c) ---> 
Selected Kernel (Router SDK) ---> 
Selected Busybox (busybox-1.13) ---> 
Selected toolchain (rsdk-1.3.6-4181-EB-2.6.30-0.9.30) ---> 
--- rtl8196c 
Selected Target of SDK (11nRouter_GW) ---> 
Selected Board Configuration (SPI flash + Squashfs) ---> 
IC Test Configuration ---> 
--- config components 
[*] Config kernel 
[*] Config users 
[ ] Config busybox 
[ ] Load default settings 
[ ] Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


3) If you turn on APMIB_SHARED feature (APMIB_SHARED = 1, users/boa/Makefile), you have to 
do the step. Otherwise, skip this step. 
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In kernel config, enter "General setup" menu to enable "System V IPC" option. 
[*] Prompt for development and/or incomplete code/drivers 
() Local version - append to kernel release 
[ ] Automatically append version information to the version string 
[ ] Support for paging of anonymous memory (swap) 
[*] System V IPC 
[ ] POSIX Message Queues 


[ ] BSD Process Accounting 


4) In users config, enable "boa" application. 
--- Applications 
[*] auth 
[*] bretl 
[*] busybox 
[ ] login on console 
[ ] Enhanced Ctorrent 
[ ] dets 
[ ] dhcpv6 
[ ] discover 
[*] dnrd 
[ ] dnsmasq 
[ ] dosfsck 
[ ] gdbserver 
[*] boa 


[ ] gproxy 


4.38.2 Directory Structure 
users 
|-- boa 


|-- apmib <----- apmib library 
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-- defconfig <----- default apmib configuration 


| 
|-- html <----- HTML pages and graphics files 
|-- src <----- source code of Boa web server 
|-- system <----- source code for system and network init 
-- tools <----- tools on x86 
*-- utils <----- flash utility 
4.38.3 ASP function 


When a user requests to get a web page, Boa web server will load the web page file and output it 
to the browser via HTTP session. If the web page with “*.htm” or “*.asp” extension file name, before 
outputting it to the browser, Boa web server will parse it to find out all ASP functions. An ASP 
function is surrounded by tag “<%” and “%>”. And if ASP functions found, it will execute the 
corresponding callback functions to dynamically generate web pages. 


ASP function has a simple syntax: <%function (...); %>. The function argument must be a C 
string which surrounded by double quotes. 


For example, 
<%getInfo ("countDownTime");%> 
var opmode=<% getIndex("wlanMode"); %> ; 


<% getDHCPModeCombobox (); %> 


ASP functions are written in the web page file. And its corresponding callback functions are 


defined on the table “root_asp” as showed below. You can see the source file “asp_page.c” for details. 


asp_name_t root_asp[] = { 
{"getInfo", getInfo}, 
{"getIndex", getIndex}, 
{"wirelessClientList", wirelessClientList}, 


{"wlSiteSurveyTbl", wlSiteSurveyTbl}, 


{NULL, NULL} 
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Please also see section 7.18 for more information. 


4.38.4 Form function 

When a user clicks the Apply button on the Web GUI to change some configuration settings, the 
action represents that the browser would send a POST request message containing a form action string 
within the request URI to the Boa web server. Once the web server receives the request, it will parse 
the request URI to get the form action string and then call the corresponding form callback function to 


do something for users. 


The form action string is defined in the html file. It has to be prefixed with “/boafrm/”. For 


example, “tcpipwan.htm” 
<body onload="Load_Setting();"> 
<blockquote> 
<h2><font color="#0000FF">WAN Interface Setup</font></h2> 


<form action=/boafrm/formWanTcpipSetup method=POST name="tcpip"> 


The corresponding form callback functions are defined on the table “root_form” as showed below. 
You can see the source file “asp_page.c” for details. 


form_name_t root_form[] = { 
{"formWlanSetup", formWlanSetup}, 
{"formWlanRedirect"”, formWlanRedirect}, 


{"formWep", formWep}, 


{NULL, NULL} 
ki 


Please also see section 7.18 for more information. 


4.38.5 No Ejscript Support 
Ejscript is a server-side script language. Boa web server does not support this feature. If your web 
pages have this kind of script, you should re-write them. In general, you can use JavaScript and asp 


function to implement the same functionality provided with Ejscript. There are many examples in our 
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Boa web server. Please see source codes for details. 


For example, in “users/goahead-2.1.1/web-gw/tcpipwan.asp”, the following Ejscript codes in blue are 
not supported on Boa. 


<td width="30%" height=40><font size=2><b>WAN Access Type:</b></td> 
<td width="70%"> <font size=2><select size="1" name="wanType" onChange="wanTypeSelection(this)"> 
<option <% if (getIndex("wanDhcp")==0) write("selected"); %> value="fixedIp">Static IP</option> 
<option <% if (getIndex("wanDhcp")==1) write("selected"); %> value="autoIp">DHCP Client</option> 
<option <% if (getIndex("wanDhcp")==3) write("selected"); %> value="ppp">PPPoE</option> 
<option <% if (getIndex("wanDhcp")==4) write("selected"); %> value="pptp">PPTP</option> 
<td width="70%"><font size=2><select size="1" name="pppConnectType" onChange="pppTypeSelection(0)"> 
<% var type = getIndex ("pppConnectType"); 
if (ype==0 ) { 
write (“<option selected value=\"0\">Continuous</option>‘); 
write (“<option value=\"1\">Connect on Demand</option>“); 
write (“<option value=\"2\">Manual</option>*); 
} 
if (type == 1) { 
write (“<option value=\"0\">Continuous</option>“); 
write (“<option selected value=\"1\">Connect on Demand</option>“); 
write (“<option value=\"2\">Manual</option>“); 
} 
if (type == 2) { 
write (“<option value=\"0\">Continuous</option>“); 
write (“<option value=\"1\">Connect on Demand</option>“); 
write (“<option selected value=\"2\">Manual</option>“); 
} %> 
</select> &nbsp;&nbsp; 


<input type="submit" value="Connect" name="pppConnect" onClick="return pppConnectClick(0)">&nbsp;&nbsp; 
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<input type="submit" value="Disconnect" name="pppDisconnect" onClick="return pppConnectClick(1)"> 
<% if ( getIndex("pppConnectStatus") ) write("\n<script> setPPPConnected(); </script>\n"); %> 
</td> 
In “users/goahead-2.1.1/web-gw/ wlbasic.asp”, 
var countrystr= "<% getInfo ("country_str"); %>"; 
var wlan_idx= <% write (getIndex("wlan_idx")); %> ; 
var opmode=<% write (getIndex("opMode")); %> ; 
var WiFiTest=<% write (getIndex("WiFiTest")); %> ; 
var ssid_2g="<% write (getIndex("2G_ssid")); %>"; 
var ssid_5g="<% write (getIndex("5G_ssid")); %>"; 
var info_country=<% getInfo ("info_country");%>; 
<SCRIPT> 
<%_ val = getIndex("RF Type"); 
write ("RFType[wlan_idx]="+ val + ";\n"); 
val = getIndex ("wlanMode"); 
write ("\tAPMode[wlan_idx]="+ val + ";\n"); 
val = getIndex ("band"); 
if (val > 0) val = val-1; 
write ("\tbandIdx[wlan_idx]="+ val + ";\n"); 


%> 


4.38.6 Boa configuration file 

Boa configuration file “boa.confis put in the directory “users/boa/src” and it should be installed into 
the directory “/etc/boa/’ of the root file system. Please check the target “romfs:” in the 
“users/boa/Makefile” for details. Since the file is self-documented, it’s easy to understand the meaning 
of each setting. So we just list some useful settings here for reference. 


Port 80 # The port Boa listens on. 
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PidFile /var/run/webs.pid # where to put the pid of Boa process 
DocumentRoot /web # The root directory of the HTML documents 
MimeTypes /etc/boa/mime.types #This is the file that is used to generate mime type pairs 
# and Content-Type fields for boa. 
DefaultType text/html #MIME type used if the file extension is unknown, or there 


# is no file extension. 


4.38.7 no-cache 
To prevent the browser from caching the web page, you can add the following HTML Meta Tags to 
your page directly. 


<meta http-equiv="Pragma" content="no-cache"> 
<meta HTTP-equiv="Cache-Control" content="no-cache"> 


<meta HTTP-EQUIV="Expires" CONTENT="Mon, 01 Jan 1990 00:00:01 GMT"> 


Additionally, you can add a asp function “<% getIndex("no-cache"); %> “ instead. 


For example, in “users/boa/html/tcpipwan.htm” 
<html> 


<! Copyright (c) Realtek Semiconductor Corp., 2003. All Rights Reserved. -> 
<head> 

<meta http-equiv="Content-Type” content="text/html"> 

<% getIndex("no-cache"); %> 

<title>WAN Interface Setup </title> 


<style> 


4.38.8 Migration from old web server to Boa web server 
To port your code of old web server to Boa web server, the following action items are needed. 


1) asp and form function codes should be porting to “users/boa/src/”’. The definition of asp and form 


functions should be added to the table “root_asp” and “root_form” in “asp_page.c” respectively. 
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2) web pages should be porting to “users/boa/html/”’. 


3) form action name should be renamed to be prefixed with “/boafrm/”. So web pages should be 
modified. 


4) review your web page to find out all Ejscript code and rewrite them. 


5) The header file “users/boa/src/port.h” defines some useful macros. Include the header file “port.h” 
to your source code to get more compatibility. 
6) The prototype of asp callback function on the old web server is different from Boa. You should 
modify them to be the same as Boa. 
7) Some header files included in your source code are not existed in Boa now. You should remove or 
comment out those statements. Additionally, you need to include "boa.h" and "asp_page.h" in your 
source as below. 

#include "boa.h" 

#include "asp_page.h" 
8) There are a lot of porting examples in the directory “users/boa/src” and “users/boa/html”. If you 
have a problem, we recommended that you should compare old source code and Boa source code first 
and then you can quickly find out the answer. 


4.41 uWiFi support 
4.39.1 uWiFi Introduction 


uWiF‘i is used to negotiate with uWiFi manager that is installed in Windows PC. Users can use 
uWiFi to change the share method of USB storage device. Either share by HTTP or by uWiFi method. 
If the method is http, then users can Brower/upload/Delete files on USB storage device which 
connected to Realtek RTL819x Wireless Home Gateway via http protocol. If the method is uWiFi, 


then users can use uWiFi manager to connect the storage device. 


4.39.2 Configuration for uWiFi support 
1) Kernel configure for uWiFi 


All of the settings of HTTP File server should be included, the additional configuration 
iS: 
Device Drivers ---> 


[*] Staging drivers ---> //Select 
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[*] RTK USB uWiFi host driver //Select 


2) Application configure for u WiFi: 


All of the settings of HTTP File server should be included, the additional 


configuration is: 
[*] uWiFi // selected 
[*] nmbs // selected 
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4.39.3 WEB GUI Manual 


Home page: 
Realtek uWiFi B settines 
Shared Partitions: 


No shared partition available. 


Storage Device Management: 
No USB storage device available. 


Apply Changes | Reset | 


The Hyperlink “Settings” is for Router configuration, user can set share method for storage 


device that list in Storage Device Management table. In default, the method is in “uWiFi” mode. 
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Realtek uWiFi 


es Settings 


Shared Partitions: 
No shared partition available. 


Storage Device Management: 


JetFlash Mass Storage Device cHttp © uWiFi 


If the user selects share method “uWiFi”, then uWiFi Manager can see storage device icon. uWiFi 


Manager can be used to “Connect” if the current state is Disconnect. 


as REALTEK uWiFi Manager 


Semiconductor Corp. 


uWiFi Manager (fe! 


Connect. 


Connect to Me 
JetFla 
Settings Autre 


oD 


When user selects “connect”, uWiFi manager will connect to storage device. 


uWiFi Manager 


os REALTEK uWiFi Manager 


Semiconductor Corp. 


Settings 


~. 
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User can see the new drive is attached to PC 


® My Computer 
File Edit View Favorites Tools Help 


@.€ @ © 


Back Forward Refresh Copy Delete Search 


Address | @ My Computer 


Name 
Files Stored on This Computer 


© CQ My Documents Shared Documents 
ag bot se Documents 
 & SystemDisk (C:) 
® S DATA-II (0:) Hard Disk Drives 
~@ DATA €:) * 
® Q DVD Drive F:) 
& S* Removable Disk (G:) 
® © Shared Documents 
& (& tester's Documents | Devices with Removable Storage 
& © My Network Places ———_a 


SystemDisk (C:) 
DATA (D:) 
DATA (E) 


Local Disk 
Local Disk 
Local Disk 


OD Drive 


@) Recycle Bin 2DVD Drive (F:) 
(© Unused Desktop Shorter | S* Removable Disk (G:) 


Removable Disk 


uWiFi attachment information will be showed in web home page if storage device is 


attached by uWiFi mode. 


Realtek uWiFi 


Shared Partitions: 


No shared partition available. 


Storage Device Management: 


sein 


JetFlash Mass Storage Device OHttp| OuWiFi (In used by zzaadd-6toqmew9) 


Apply Changes 


uWiFi Manager can be used to “Disconnect” if the current state is Connect. 


uWiFi Manager 


BBE; 


a REALTEK uWiFi Manager 


Semiconductor Corp. 


Disconnect 
Connect to Me 


Auto Connect 


Exit 
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When user selects “Disconnect”, uWiFi manager will disconnect storage device. 


uWiFi Manager 


as REALTEK uWiFi Manager 


Semiconductor Corp. 


If the user selects share method “Http”, the partition name will be showed in “Shared 


Partitions” when it is available. 


Realtek uWiFi B settings 
Shared Partitions: 
Msdal 


Storage Device Management: 


USB Device Share Method 
JetFlash Mass Storage Device © Http c uWiFi 


User can enter the hyperlink in shared partition for file access. 


User can click the hyperlink “Name”, “Last modified”, and “Size” for sort. 


Index of /sdal 


Name Last modified Size 

Parent Directory 

0123/ 28-Oct-2010 16:07:00 - Remove | 
Wabe/ 28-Oct-2010 18:18:14 - Remove | 
=| 1.txt 20-Oct-2010 15:05:14 25.68K Remove | 


Select File] wie... | Upload | 


4.39.4 Lan NetBIOS Name query service support: 
In Lan settings, user can set LAN NetBIOS name for Realtek RTL819x Wireless Home Gateway. 
The default value is “uWiFi”. 
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LAN Interface Setup 


This page is used to configure the parameters for local area network which connects to the LAN port of 
your Access Point, Here you may change the setting for IP addyesss, subnet mask, DHCP, etc., 


IP Address: /192.168.1.254 

Subnet Mask: (255.255.2550 | 

Default Gateway: Ct 

DHCP: | Auto a 

DHCP Client Range: {192 168.1100 |-|1921681.200 | 
DHCP Lease Time: = 480 ~ 10080 minutes) 

suc DHCP 

Domain Name: Realtek | 

LANBIOSNAME: = uWiFi | 


802.1d Spanning Tree: | Disabled v | 


Clone MAC Address: [000000000000 


Apply Changes Reset 


Users can use LAN BIOS Name to connect Realtek RTL819x Wireless Home Gateway. 


© Realtek uWiFi - Windows Internet Explorer 


we Favorites | @Realtek uWiFi ty GG a ~ Pagey Safety” Toosy @y ” 


Realtek uWiFi 


Shared Partitions: 


No shared partition available 


Storage Device Management: 
USB Device Share Method 
JetFlash Mass Storage Device OHttp @uWiFi (In used by zzaadd-6toqmew9) 


{ Apply Changes | Reset | 


Done ©) Local intranet 


4.42 ALL NAT 
4.40.1 what’s Multiple wan (All Nat) 


There are 2 network interfaces with different ip address. Different service packet will be routed/ 
napted to different network interface, all connection should be forwarded by hardware napt. 


And only rtl8198t & rtl8196ct & rtl8198c & rtl8197fsupport this feature! 


4.40.2 How to enable/disable Multiple wan 
1. menuconfig: 


Device Drivers ---> 
[*] Network device support ---> 


[*] | Options for Realtek SoC ---> 
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Config for Layered Driver Features ---> 


[*] | Enable multiple wan in hw nat mode 


£ wenjian_jia@APServer197: /branch_2.5 tag - Eshell 3.0 


Hoot Aho Geos (oo fae 
oa @C|a- Be 42 B- @- GW” : Font |Courier new viiz ¥ 


ddr e ssh: //wenjian_jia:#eeeeeekO1 72. 29,38. 197/22 “i 


1 172. 29.38, 197 2 172.29.38.197 | 3 172.29.38.197 


Config for Layered Driver Features 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


*** Choose basic features. *** 
*** Choose hardware features. *** 

Hardware Features Selection (Enable RTL Hardware NAPT) ===> 
*** Choose advance features. *** 


enable n 8 d if mapping 


] tiple wan 
] Rtl665x lan port restriction 
] HW Qos support vlan priority 
] Support multi-vlan in bridge/wisp mode 
] Enable RTL local public 


2. Network interface 


ifconfig -a, interface ethX is created for multiple wan feature. 
ex. eth1:192.168.2.11/24, eth6:192.168.3.11/24 


3. ip configuration 


configure ip address for this interface. please use advanced route if the two wan interface in same subnet. 
ifconfig ethl 192.168.2.11 netmask 255.255.255.0 
ifconfig eth6 192.168.3.11 netmask 255.255.255.0 


4. Iptables rule configuration 


configure iptables rule: 

iptables —F 

iptables -P INPUT ACCEPT 
iptables -P FORWARD ACCEPT 


iptables -t nat -F 
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iptables -t nat -A POSTROUTING -s 192.168.1.0/25 -o eth! -] MASQUERADE 
iptables -t nat -A POSTROUTING -s 192.168.1.128/25 -o eth6 -] MASQUERADE 


5. adv route configuration 


add/del rtl adv route to proc/adv_rt, the format is: 


"add/del srcip_start srcip_end dstip_start dstip_end extIp nexthop outinterface" which means that packet whose 
source ip address in srcip range and destip address in dst range will be forwarded to nexthop, and the napt ip address 


is extIp. 
Ex. 


echo "add 192.168.1.128 192.168.1.255 192.168.3.0 192.168.3.255 192.168.3.11 192.168.3.253 
eth6">/proc/adv_rt 


Note: When test with eth6, you should set the wan PC ip as nexthop(192.168.3.253). 


4.43 Proc filesystem for debug 


There are several proc filesystem and command provided for debug. 


4.41.1 How to enable proc filesystem for debug 
make linux_menuconfig 


Device Drivers ---> 
[*] Network device support ---> 
[*] | Options for Realtek SoC ---> 


[*] Enable proc filesystem for debug 
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Options for Realtek Soc 


[ol Enable proc filesystem for debug 


s 
r 
a 

D 


4.41.2. Proc illustration: 
CASE 1: 

When Enable proc filesystem for debug is selected, Marco CONFIG_RTL_PROC_DEBUG=y, all 
the proc entry defined in rtl865x_proc_debug.c will be established in /proc/rtl865x/.. 
CASE 2: 

When Enable proc filesystem for debug isn’t selected, Marco CONFIG_RTL_PROC_DEBUG=n, 
only the following proc entry will be established: (Marco: CONFIG_ RTL_DEBUG_TOOL, default y) 

asicCounter fc_threshold memory phyReg 


diagnostic mac mmd port_status 


4.41.3. Command illustration: 
The following command is enabled when 
CONFIG_ RTL_DEBUG_TOOL]|CONFIG_RTL_PROC_DEBUG 
1). dw 
Description: 
command to read value from memory 
Input Format: 
dw <Address> <Len> 
Output Format : 
Address : data 


2).ew 
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Description: 

command to write value to memory 
Input Format: 

ew Address value 
Output Format : 


Address : value 


3). phyr 
Description: 
read value from phy register 
Input Format: 
phyr phyld pageld regId 
Output Format : 
extRead phyld, pageld, regId, regData 


4). phyw 
Description: 
write value to phy register 
Input Format: 
phyw <phyld> <paglId> <regId> <regData> 
Output Format : 
extWrite phyld, pageld, regId, regData 


5) .mmd_cmdr 
Description: 

read EEE information by mmd proc entry 
Input Format: 

mmd_cmdr phyID deviceID addressID 
Output Format : 

read phyld, devId, regld, regData 


6) .mmd_cmdw 
Description: 

write value to phy register by mmd proc entry 
Input Format: 

mmd_cmdw <phyld> <devId> <regId> <regData> 
Output Format : 

extWrite phyld, devId, regId, regData 
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4.44 TR069 Support 
4.44.1 Specification Version 
Comply with: 
1. TR-069 CPE WAN Management Protocol v1.1 


Version: Issue 1 Amendment 2 
Version Date: December 2007 


2. TR-098 Internet Gateway Device Data Model for TR-069 
Issue: 1 Amendment 2 
Issue Date: September 2008 


3. TR-181 Device Data Model for TR-069 
Issue: 2 Amendment 2 


Issue Date: February 2011 


4. TR-104 VoiceService:1.0 Service Object definition for TR-069 
Issue Date: September 2009 
4.44.2. Supported RPC Method 


GetRPCMethods 
SetParameter Values 
GetParameter Values 
GetParameterNames 
SetParameter Attributes 
GetParameter Attributes 
AddObject 
DeleteObject 

Reboot 

Download 

Upload 

FactoryReset 
ScheduleInform 
Inform 
GetAllQueuedTransfers 
GetQueuedTransfers 


CancelTransfer 
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4.44.3. Supported Data Model 
-  TR-098 Amendment 2 
@ Please see Realtek _TR-069_Data_Model_Support_List_098_181_143.xlsx 
- TR-181 Issue 2 Amendment 2 
@ Please see Realtek _TR-069_Data_Model_Support_List_098_181_143.xlsx 
-  TR-104 
@ Please see Realtek_TRO69_TRO098_TR181_SupportList. pdf 
4.44.4. ACS Server Tested 
- Comtrend 
- OpenACS 
4.44.2. Code directory 
/users/cwmp-tr069_v2/cwmpClient: data model definitions and utilities. 
/users/cwmp-tr069_v2/gsoaplib: gsoap library 
/users/cwmp-tr069_v2/lib: TR-069 engine library 
/users/cwmp-tr069_v2/include: TR-069 engine header files 
/users/cwmp-tr069_v2/matrixssl-1-8-3-open: matrixSSL library 
4.44.6. Compile TR-069 


make linux_menuconfig: 
For Linux-2.6.30 kernel, please select the following configuration: 


Device Drivers ---> 


Memory Technology Device (MTD) support — ---> 


--- Memory Technology Device CMID) support 
[J] Debugging 
[] MID concatenating support 
*] MID partitioning support 
]  RedBoot partition table parsing 
J Command line partition table parsing 
] TI AR? partitioning support 
*** User Modules And Translation Layers *** 
Cel irect char device access to MID devices 
-*- Common interface to block layer for MID ‘translation layers 
[*] Caching block device access to MID devices 
{] FIL CFlash Translation Layer} support 
{J NETL CNAND Flash Translation Layer) support 
[ ]  INFTL CInverse NAND Flash Translation Layer) support 
CJ 


Resident Flash Disk ¢€Flash Translation Layer) support 
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For Linux-3.10 kernel, skip “Memory Technology Device (MTD) support” selection 


Machine selection ---> 
System Configuration  ---> 


(0x20000) CWMP Transfer Queue partition size in flash. 


(0x20000) CWMP Notification partition size in flash. 


make users_menuconfig: 
enable “tr069” option ( including select its detailed suboptions) and mtd name mapping. 
[*] tr069 
TRO069 Root Data Model (TR-098)  ---> 
TRO69 Optional Data Model ---> 
TRO069 SSL Type (support OPENSSL) — ---> 
other features ---> 


[*] mtd name mapping support 
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As for tr069 detailed suboptions, please do as follows: 


Step 1: Select TR-069 root data model. 

At this moment, two kinds of root TR-069 data model are supported, which are TR-181 and 
TR-098. Note that these two root data models are exclusive. 

TR-098 is default root data model. 
Step 2: Select additional TR-069 data model if needed 

If no further additional TR-069 data model is expected, skip this step. 

At this moment, the following data model or options are supported. The options vary by root 


data model that is selected. 


[J] enable TR-181 Y6 part support 
[ ] enable TR-111 support 
[ ] enable TR-143 support 


L ] enable TR-@98 gos support CNEW 
[ ] enable TR-111 support 
[ ] enable TR-143 support 


a. enable TR-098 qos support 
If selected, following TR-098 data model will be supported: 
InternetGatewayDevice.QueueManagement.Queue. {i}. 
InternetGatewayDevice.QueueManagement.Classification. {i}. 
InternetGatewayDevice.QueueManagement.App. {i}. 
InternetGatewayDevice.QueueManagement.Flow. {i}. 
InternetGatewayDevice.QueueManagement.Policer. {1}. 
InternetGatewayDevice.QueueManagement.QueueStats. {i}. 
Also if selected, QoS mechanismwill also be changed. 
b. enable TR-181 V6 part support 
To make TR-181 V6 part supported, IPv6 must be supported. Please refer to chapter 
4.15. 
c. enable TR-111 support 
If selected, TR-069 Annex G will be supported. 
d. enable TR104 support 
To make TR-104 supported, VOIP must be selected as follows: 
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If rtk_voip is enabled, the support TR104 in TRO69 option will appear. The supported 
ICs are only RTL8954C and RTL8972D. 


e. enable TR-143 support 
If selected, the following data models will be supported: 
InternetGatewayDevice.DownloadDiagnostics. 
InternetGatewayDevice. UploadDiagnostics. 
InternetGatewayDevice. UDPEchoConfig. 
Step 3: select SSL type TR-069 expected to support 


At this moment, TR-069 supports “no SSL support”, “openssl support” and “matrixssl 
support”. 
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©Msupport OPENSSL 


Note: 


If “support OPENSSL” is selected, openssl-0.9.81 is selected as default openssl library. To 
support TLS1.1 and TLS1.2, please select openssl as 1.0.2d manually. 


make menuconfig -- Config busybox: 
To support FTP file transfer in TR-069, please select the following options in busybox: 


Networking Utilities ---> 
[*] ftpget 
[*] ftpput 
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4.44.7. Configure TRO69 


Enable/Disable Tr-069 from WEB GUI: 


WLAN Access Point 
Setup Wizard 


The setup wizard will guide you to configure access point for first time. Please follow 
the setup wizard step by step. 


Welcome to Setup Wizard. 


The Wizard will guide you the through following steps. Begin by clicking on 
Next. 


. Setup Operation Mode 

. Choose your Time Zone 
Setup LAN Interface 

. Setup WAN Time Zone 

. Wireless LAN Setting 


. Wireless Security Setting Next> 


OnfkWN = 


TR-069 Configuration 


This page is used to configure the TR-O69 CPE. Here you may change the setting for the ACS's parameters. 


TRO69: © Disabled © Enabled 
ACS: 

URL: http://1 72.21.146,44cpe/Ppdl 28 
User Name: [sd9_e8 

Password: {1234 

ener Ante ® Disabled © Enabled 
Periodic Inform [i 

Interval: 


Connection Request: 


User Name: 123456 
Password: [123456 
Path: [i069 
Port: |4567 


Apply Changes | Undo | 


When TR-069 is compiled with any SSL library, ACS URL can be set with prefix “https://”. 


When TR-069 is compiled with any SSL library, CA certificate can be uploaded in webpage(Used 
to verify ACS certificate): 
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TR-069 Configuration 


This page is used to configure the TR-069 CPE. Here you may change the setting for the ACS's parameters. 


TRO69: Disabled © Enabled 

ACS: 

User Name: penacs 

Password Jopenas ss ssS—S™S 
phoning oe Disabled © Enabled 

Periodic Inform [so 
Interval: 

Connection Request: 

User Name: [i356 
Password fizssse tt ttsti‘is~S™S 
Path: jroo sts—S 
Port fs000  sts—S 


Save Save & Apply Undo | 


ARE, 


Uploaded CA certificate will be stored in device as /var/cwmp_config/cacert.pem. 


Note: 


When MatrixSSL is selected as TR-069 SSL library, valid CA certificate must be uploaded, 


for which will verify ACS certificate even if there’s no CA certificate in device. If no valid CA 


certificate exist, ACS certificate verification will fail and device can’t connect to ACS. 


4.44.8. Debug TR-069 


TR-069 debug system is controlled by following two mib items: 


1. MIB_CWMP_DEBUG_MODULE: 


Device which TR-069 module debug message to be shown, including: 


MODULE_CORE 
MODULE_SERVER 
MODULE_RPC 
MODULE_FILE_TRANS 
MODULE_NOTIFY 
MODULE_DATA_MODEL 
MODULE_TR_143 


Use bitwise OR to enable multiple modules. 
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=(1<<1), 
=(1<<2), 
=(1<<3), 
=(1<<4), 
=(1<<5), 
=(1<<6), 
=(1<<7), 


2 
14 
18 
16 
32 
1164 
128 


183 


2. MIB_CWMP_DEBUG_LEVEL 
Device which level of debug message to be shown, including: 
LEVEL_ERROR=0, 
LEVEL_WARNING=1, 
LEVEL_INFO=2, 
LEVEL_DETAILED=3, 
Higher the value is, more debug messages will be shown. 


4.44.9. TR-069 Annex G — Connection Request via NAT Gateway(TR-111) 


Connection Request via NAT Gateway feature can be enabled by selecting “enable TR-111 


support” in users_menuconfig. 


The related Data Model is UDPConnReq:1 Profile. The message flows can reference the Annex 
G of the TR-069_Amendment-2.pdf. This feature can be used if and only if the ACS server also 
supports the TR-069 Annex G. 


4.44.10. TR-098 QoS Support 


- Users menuconfig 


TR@69 Optional Data Model 
selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> includes, < 
yp Search. Legend: [*] built-in [ ] excluded <M: module < > module capable 


[.J enable TR-@98 qos support 
[ ] enable TR-111 support 
[ ] enable TR-143 support 


- Note 
Enable TR-098 qos will cost extra 5kbytes for flash mib storage. 


On 96e, 97dl or 8881a platform, due to current setting/defaulg setting is 16k, it's not large enough 
to support TRO98 qos, need manually adjust the flash mapping. 


Eg: when load 97dl default settings, flash mapping as follows: 
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Please also be aware of that, since the flash mib offset has been changed, it will lead to flash load 
default at the first time of loading new image. 


4.44.11, Reference documents 


Realtek_TR-069_How_to_Add_the_TR-69_Parameters.pdf 
4.45 ALG Support 
4.43.1 DESCRIPTION 
SDK support the following alg: 
1. SIP; 
2. FIP; 


3.. TEIP; 
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4. H323; 
5. PPTP; 
6. L2TP; 
7. RTSP; 
8. IPSEC; 
4.43.2 How to enable ALG 
make linux_menuconfig 


Take enable IPSEC ALG as an example: 


r 


] IPSEC protocol support} 


Other ALG could be enabled similarly. 


Note: The feature is only supported on main trunk now. 
4.46 Cone Nat support 
4.44.1 How to Enable Cone Nat via config 
make linux_menuconfig 
-> Networking support (NET [=y]) 
-> Networking options 
-> Network packet filtering framework (Netfilter) (NETFILTER [=y]) 


-> IP: Netfilter Configuration 
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-> IP tables support (required for filtering/masq/NAT) (IP_NF_IPTABLES [=y]) 
-> Full NAT (NF_NAT [=y]) 
-> MASQUERADE target support (IP_NF_TARGET_MASQUERADE [=y]) 


-> IP_NF_TARGET_CONENAT [=y] 


Ip: Netfilter Configuration 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


Proc/sysctl compatibility with old connection tracking 
IP Userspace queueing via NETLINK (OBSOLETE) 
*] Ip tables support (required for filtering/masq/NAT) 
"addrtype”" address type match support 
"ah" match support 
"ecn" match support 
"ttl" match support 
* Packet filtering 
REJECT target support 
LOG target support 
ULOG target support 
*] Full NAT 
i MASQUERADE target support 
[el] CONENAT target support 
NETMAP target support 
REDIRECT target support 
Basic SNMP-ALG support 
* Packet mangling 
CLUSTERIP target support (EXPERIMENTAL) 
i} ECN target support 
"TTL" target support 
raw table support (required for NOTRACK/TRACE) 
ARP tables support 


< Exit >  < Help > 


4.44.2 How to Enable Cone Nat via proc 
/proc/conenat 


This proc is used to select the nat type : 


— 


echo 0 > /proc/conenat, it is symmetric nat; 


~ 


echo | > /proc/conenat, it is full cone nat; 


(oS) 


echo 2 > /proc/conenat, it is restricted cone nat; 


- 


echo 3 > /proc/conenat, it is port restricted cone nat. 


Note: The feature is only supported on main trunk now. 


4.47 Miniigd IP v6 support 
4.45.1 How to Enable Miniigd ipv6 support via config 
make users_menuconfig 
---Applications 


[*] miniigd 
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[*] miniigd ipv6 support 


RLX Linux Configuration 


the menu. <Enter> selects submenus --->. Highlighted letters are hot 
jes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
ccluded <M> module < > module capable 


(-) 
{ ] mdadm-3.2.5 
{ ] minidina 
Te dina_dms 
[*] libiconv 
{*] miniigd 


4.48 WPS supported for Virtual Client in repeater mode 


Original WPS is only support for root interface whether wireless is AP mode, Client mode or 


enable repeater in AP mode. But if you need WPS is support for virtual client (wlanX-vxd) in repeater 


mode. You can open the flowing compiler flag, the WPS will switch to support virtual client 
(wlanX-vxd). 


1. 


Turn on compiler flag “CONFIG REPEATER WPS SUPPORT” and 
“CONFIG WPS EITHER AP OR_VXD” in apmib.h 


When Repeater is disabled, the WPS is working for root AP/Client interface. 
When Repeater is enabled, the WPS is working for virtual client interface. 
Only Turn on compiler flag “CONFIG REPEATER WPS SUPPORT” in apmib.h 


When Repeater is disabled, the WPS is working for root AP/Client interface. 


When Repeater is enabled, If virtual client interface is connected, the WPS is working for root 


interface, If virtual client interface is not connected, the WPS is working for virtual client 


interface. 


4.49 Jumbo frame support 


4.48.1 How to enable jumbo frame support via config 


make linux_menuconfig 


---device driver 


[*] network device support 


[*] options for realtek soc 
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[*] Jumbo frame support 


Options for Realtek SoC 


4.50 11AC/HS2R1 Logo Test by Sigma Support 


4.48.1 How to enable jumbo frame support via config 


1. Enable Telnetd and Login support in busybox, please follow the instruction of section 4.33, it’s 
strongly recommended that set user name “root” without any password. (default setting of 


AP_ControlAgent application) 


2. Enable Sigma Utility 


make users_menuconfig 
--- Debug & Test 


[*] sigma utils 
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i Debug & test Settings —— 


Sigma Program (VHT5G) 


Select Sigma Program (VHT5SG for AC or HS2R1 for HS2.0 Release 1) 
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Sigma Program 
Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
<?> for additional information about this option. 


( ) Hs2R2 


Ph 


4.48.2 How to launch Telnetd 
In default, Telnetd daemon will not be launched automatically, user can try command in console 
telnetd & 


or, user can add such command line to file “sdk/users/script/cinit/init.sh” 


telnetd & 


4.48.3 How to use Realtek AP_ControlAgent for Sigma test 
Loading an image with support of sigma utility, login & telentd (root user with no password), 


APUT can be collocated with AP_ControlAgent to run sigma test. 


Inside of AP_ControlAgent package we provided, there are documents in the folder named 
\Document to instruct user how to config & launch this utility. 


About the whole setup of 1 lac sigma environment, please follow the documents from WFA 
website. (http://www. wi-fi.org/) 


4.51 Hotspot 2.0 Support 

1) CONFIG FILES 
Before building image, an engineer needs to modify HS2.0 ANQP Information in CONFIG Files 
(SDK/ users/hs2/ hs2_wlan0.conf or SDK/ users/hs2/ hs2_wlanl.conf). Please refer to WFA 
Hotspot 2.0 release 1 spec and test plan for how to set the values in CONFIG files. When sigma 
auto test, CONFIG file will be set automatically by Control Agent. 


2) kernel configure 


make linux_menuconfig //To configure linux kernel 
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Linux kernel menu as follows: 


Device Drivers ---> //enter 
[*]Network device support ---> //selected and enter 
Wireless LAN ---> //enter 
[*]RTL8192C/D 802.11b/g/n support selected 
[*]Realtek 8192D wireless support //selected 
[*]Realtek HS2.0 Support //selected 


0.9 Configuration 


Wir 


[*] built-in 


support 
[*] Realtek H82.0 support 


2) The user can enable/disable HS2 on web UI. 


In Hotspot 2.0 spec, AP supports HS2 function only when the security type of AP is set to 802.1X. So, 
before enabling HS2, users need to set Security Type to 802.1X mode. 


web UI menu as follows: 
Wireless ---> 
wlanl (5GHz) / wlan2(2.4GHz) ---> 
Security ---> 
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WLAN Access Point 
Wireless Security Setup -wlan1 


This page allows you setup the wireless security. Turn on WEP or WPA by using Encryption Keys could 


Select SSID: | Root AP - NEC AP 5G v| [Apply Changes 


Encryption: WPA2 | 


Authentication Mode: © Enterprise RADIUS) © Personal Pre-Shared 
Key) 
WPA2 Cipher Suite: TKIP MAES 


RADIUS Server IP Address: 192.168.1.188 


RADIUS Server Port: 1812 


RADIUS Server Password: [s seananaus 
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The ON/OFF for HS2 setting 


web UI menu as follows: 
Wireless ---> 
wlanl (5GHz) / wlan2(2.4GHz) ---> 
Advanced ---> 
enable / disable HS2 


WLAN Access Point 
Wireless Advanced Settings -wlan1 


These settings are only for more technically advanced users who have a sufficient knowledge about wireless LAN. 
on your Access Point. 


4.52 Hotspot 2.0 Release 1 Logo Test 


Apply Changes Reset 


Fragment Threshold: 2346 (256-2346) 
RTS Threshold: 2347 (0-2347) 
Beacon Interval: 100 (20-1024 ms) 
IAPP: @Enabled ODisabled 
HS2: @Enabled ODisabled 
Protection: OEnabled © Disabled 
Aggregation: @Enabled ODisabled 
Short GI: @Enabled O Disabled 
WLAN Partition: OEnabled © Disabled 
STBC: Oknabled © Disabled 
LDPC: Oknabled © Disabled 
TX Beamforming: OEnabled © Disabled 
Mutilcast to Unicast: @Enabled ODisabled 
RF Ouiput Power: © 100% O70% O50% 


1) Please follow 4.50-2 to enable Hotspot 2.0 during compile time 


2) For logo test, there are several features have to be enabled as well: (Or follow 4.33) 
I. Remote login DUT through ssh protocol 
i Enable telnetd through menuconfig of busybox 


Please reference snapshot below to enter menuconfig of busybox 
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, save and exit. Then enable /ogin service within “Login/Password Management 
Utilities” and telnetd service within “Networking Utilities”. Please reference snapshots 
below. 


And modify the default administration control configuration to enable root remote login. 
The configuration file is located at SDK/boards/rtl8 19xD/etc.default/passwd (The 
location is for example while platform is RTL8197D SoC with both 8812 and 92E 
wireless chips). Change the line from “root:x:0:0:root:/:/bin/sh” to 
“root::0:0:root:/:/bin/sh” 


Finally, recompile SDK. To make sure, after firmware upload to DUT, telnetd should be 
located through console command. And /etc/passwd carry the correct configuration. 


ii. Enable configuration relay utility sigma_util 


Enter menuconfig of user space applications as below: 
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and Exit. 


Select sigma_utils to support HS2R/ 


Note, if ever build SDK to support 802.11 AC logo test, make sure to rebuild directory 


of /users/sigma_utils. 
II. Release Control Agent to Lab 
Note, please make sure test Lab modify control agent follow rules of: 
1. HESSID do not include colon 


2. AP's MAC Address keep FF: FF:FF:FF:FF:FF 


4.53 Multiple repeater mode and multiple mac clone 
Multiple repeater mode 
Turn on compile flag “CONFIG_RTL_ MULTI REPEATER MODE_ SUPPORT” from config file 


or make menuconfig as below Fig. 
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-config - Linux Kernel v2.6.30.9 Configuration 
qqqgqrraaarasasarararaqaqagagaaaaaaaaaaaaaagaaaaagaagaqagaaaaaaaaaaaaaaaaaagaaaagaagag 
laqqgqaqgaqaqagaqgqagaqagaaggagd Wireless LAN qqqqqqqqqqaqqqaqqaqaqaaqaqaggqagk 
x Arrow keys navigate the menu. <Enter> selects submenus --->. x 
Highlighted letters are : ing <Y> includes, <N> excludes, 
<M> modularizes features. Press c>< oO exit, <?> for Help, </> 

for Search. Legend: [“] built-in c <M> module < > 

© lqqqqqqqqqqqqqqqaqqaqqqqaqaqqaqaqdqdqddqddqqqqqdqaaqqdqadqd¢d¢d¢d¢dqd¢dadgd¢adgagqaagagagagqagaagk 

[ ] Wireless LAN (pre-802.11) 

[ ] Wireless LAN (IEEE 
] Realtek 
] Realtek 
] 
] 


mR KM 


* 


am OM 


*“] RTL8192¢ 
Use PCIe 
PCIe Slot 0 devic } support 
PCIe 
PCIe ° > Tx Beamforming 
PCIe c > Antenna Diversity 
Private skb buffer management 


* 


we 


[ 
[ 
[ 
[ 


i | 
Pr 


| 
mM 
t + 
ce mM Mm OM 


* 
& 


Virtual AP Support 
Client Mode Support 


+ 


So 


Repeater Mode support 
multiple e support 
Client Mode 802.1x Support 


Ce i eT 
x 


t 


Multiple AP profile Support 
WDS Support 
Efuse Support 
WAPI Support 
Config File support 
Wireless Tools v239 support 
MP quick PSD support 
Realtek P2P support 
Realtek wps2.0 support 
Band Edge Limit support for 92C/92D/8812/88E/92E/88 
RTL Mesh Sup t 
Enable WLAN Filter 
Realtek HS2.0 support 


*“ 
Py 
mm OM 


* 


x 
x 
x 
x 
x 
x 
x x 
x 
x 
x 
x 
x 
x 


Ce i i i 


+ 


MMM MRM MRK 
sei con pak es Gk; We cos pa a | as) id, 
cM RRM MMH 


MRM MR MMM RR 
mM OM 


maqqqqqqqaqaqqqaqqgggqaqqqgqgqaqgqqqgqqaqaqaqaqqgggqagqaqqgqaggqaqgqqqaqggqaqaqqggagqqaqggaaagy 

tqqqqqqqqqqgagqqqgaqaqgagaagggagagggaggggagggaaggggagqdgagagggaagdggaaadgagagaggaggagdqgdggggu 
x <Select < Exit > < Help > x 
maqqqqqqqqqqqagqgqqqqaggqaqqaqaggqaqqaqqggqgqqqaqqgggqqaqaqgggqqqagggqgqaqqagqggqaqaqaaqaggaay 


* 


Turn on the feature from web page as follows 


Step 1: In web UI, enter “basic setting”->” multiple AP/multiple repeater mode” 
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A UREADTEK WLAN Access Point 


@ Site contents: Wireless Basic Settings -wlanl 
Setup Wizard 
J Operation Mode 
—] Wireless 
HB BandMode 


a 
we 


This page is used to configure the parameters for wireless LAN clients which may connect to your 
Access Point. Here you may change wireless encryption settings as well as wireless network parameters. 


[] Disable Wireless LAN Interface 


ome Band: SGA | 
Security | | 
j Access Control AP a 
ij WDS settings Mode: 
| Site Survey MultipleAP-MultipleRepeater 
Spiers Network Type: 
Schedule 
ME wian2(2.4GHz) SSD: RTK ln AP 5G 
@& TCP/IP Settings ———— 
@ Firewall Channel Width: 40MHz | 
B 0S Control 
BH Route Setup Sideband- 
& Management Cl} 1 
Number: a he 


Step 2: enable the check box of “Enabled multiple-repeater mode”, then root and vap0 interfaces, 
eg. wlan0 and wlanO-va0, will be enabled at AP mode and vap1 and vap2, e.g. wlanO-val and 
wlan0-va2, will be enabled under STA mode. 

Note: Don’t enable wlan0-va3 and wlan0-vxd when multiple-repeater is enabled; 


A IREALTEK, WLAN Access Point 


= Site contents: Multiple APs 


Setup Wizard 
This page shows and updates the wireless setting for multiple APs. 


api | | ] AP 


= Wireles 


i BandMode 
7 


RTK ln AP V) [ 
gs AP2 5 GHz (& RTK 11n AP VJ | Auto Enabled LAN+WAN | //0 0 | [Show] |STA 
BB Site Survey P2 Z(A+N) v n | | Au v v + v (Ser) 
B wes apa |[¥)| |5GH2(A4N) v| RTK1InAPV) | Auto v| Enabled v LAN+WAN v) (0 0 | [Show] [STA 
B Schedule 
@ wian2(2.4GHz) APS AP 
f TCP/IP Settings 
i Sang 7] Enable Multiple Universal Repeater Mode (Acting as AP and client simultaneouly); root as AP, vid be disable, vapl as AP, vap2.as STA, vap3 as STA woot and vap2 at repeater], vapl and vap3 at repeater 
‘0. 
Hc (Arn Canes) 
A Reset 
@ Management [_Apnly Chanees 


Step3: Fill SSID text fields at AP2, i.e. repeater 1’s STA interface (R1_STA) and AP3, i.e. 
repeater2’s STA interface (R2_STA) where the SSID texts should be the SSIDs that R1_STA and 


R2_STA try to connect, if the target remote AP has enabled encryption, setting security at security 
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WLAN Access Point 
Multiple APs 


This page shows and updates the wireless setting for multiple APs. 


5GH2 (AN) v) RTKIInAPV| Auto y) | Ena LAN+WAN v Show 
ap2| [] |5GHz(4N) v||[RemoteAPL |/ Auto || Enabled — abled | [LANWAN y)|[0 | |[0 Show | STA 
ap3| ©] | 5GH2(é4N) ¥ ||[RemoteAP2] | | Auto ¥| [Enabled v) LAN+WAN ¥| [0 | [0 [STA | 
APS [RTK In AP V] N ||| STA | 


“| Enable Multiple Universal Repeater Mode (Acting as AP and client siroultaneouly); root as AP, wd be disable, vapl as AP, vap2 as STA, vap3 as STA root and vap2 at repeater! ,vapl and yap3 at repeater? 


Step4: Under multiple repeater mode, we need to setup dual bridge interface and binding the AP1 
and STAI under brO, AP2 and STA2 under br1, the topology as below figure 


cee eal, 
ate 


Multiple mac clone: 
Turn on this feature by enabled define” RTL_ MULTI CLONE SUPPORT” from config file or 
make menuconfig. 


Support chip: 8192E 
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figuration 
qqaqaqaaaaaaaaaa qaqa qaqqaqaaaaaaaaaag 
Wireless LAN qqq : qqq qaqaqqgg 
- Highlighted letters are 
M> modulari features. Press 


Legend: ] built-in [ ] excluded 


qaqaqaqagagaqagaqagqqaqaqaqagqagqaqagqaagaqgagagagagagqaqaaqagqqqaagagkr 


(pre-t 


device q f 2 i support ) 
Enable 
Enable Tx Beam 
Enable Antenna D 
buffer management 
Virtual 
Client } 
Repeater 


Client Mode 802.1x 


x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 


Ce ee | 
mM KKM MK MK KOM MK KM KK KOM OM OM ROK OM OK OM OM 


ee | 


te RRM KR RM OR OR OM OM OM OM OM 
MMM MM MMM OM OM OM OM OM OM 


i ee D 


qaqaqqaqqaaaqagaa 
qqqqaaaqaaaaag’ 


maqaqaqqagagaqgagagaqaqgagagaqqagagaqaagagagqagaagagagqaagagagaqaagagagaqaagaqaqaagagagaagagagy : 
: J 
Multiple mac clone feature is usually enabled at repeater mode; when STAs connect to repeater 


AP and the traffic pass through from RSTA (repeater STA) to remote AP, RSTA will use a mac address 


different with RSTA’s mac to connect to remote AP, the cloned mac address is followed as the 


following rule: 
E.g. RSTA’s mac Addr is 00e04c112233 then 1* cloned mac addr should be 00e000112233, and 
2™ mac addr should be 00e0 112233, at 8192E the most cloned mac mount is 16. 


4.54 Support Russian L2TP special features 


4.52.1 Russian L2TP special features included the following: 
1. When wan type is DHCP+L2TP, and DHCP completes but L2TP fails, then it uses eth1 as the 
wan interface, and the default gateway and firewall are correct; 


2. When L2TP disconnects, it should reconnects successfully; 
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3. When L2TP daemon is killed manually, use eth] as wan interface, and the default gateway and 
firewall are correct; 

4. When unplug the network cable of wan interface after L2TP connected, it must disconnect and 
restore the case that using eth] as wan interface; 

5. Russian ISP L2TP server’s IP is the same with the PPP server’s IP, so it should add a route to 
L2TP server through eth! interface; 

6. Support DHCP option 33, 121, 249 to set static IP, and option 57 to set maximum message size; 
7. DNS servers got from DHCP procedure are internal, DNS servers got from L2TP procedure are 
external, and the internal DNS servers have high priority to parse the DNS query from client; 

8. Russia has high network bandwidth, the speed of BT testing reaches to 5MB/s. So we send the 
LCP-Echo-Reply packet in fastpath to avoid L2TP disconnect due to UDP socket congestion. 
4.52.2 How to enable the patches to support these features 

make linux_menuconfig 
-> Networking support (NET [=y]) 
-> Networking options 
-> Support Russia features ({=n]) 


4.52.3 What’s the platform could be supported 


All the patches are limited by platform, so our existed platforms are supported. 


4.53 WIFI-DIRECT (WIFI-P2P) support 
Turn on compile flag “CONFIG_ RTL_P2P_ SUPPORT” from config file or make menuconfig as 
below Fig.WIFI-DIRECT only support for 2.4G band chip for example 92¢,92c,88e,888 1a 


selectable now. 


-make menuconfig-> [ ] Config kernel (NEW)-> Device Drivers-> Network device support-> 
Wireless LAN-> [*] Realtek P2P 


©2011 Realtek Semiconductor Corp. 201 


fa ? . 


gp 172.21.69.111 - PuTTY 


: 
: 
| 
7 
x 


-config - Linux Kernel 6.30.39 Configuration - 
qqqqagaqagagagagagaaqaaqagagagaagaaagagagagagaaagagasagaaagagaaagagaagaaaaaggaaagaaagagagaagaaagagaag 
lqaqaqgagagqaqagagqaqaqagagagaaqaqagd Wireless LAN qqqqqqqqqqaqaqaqaqagqaqaqagagagaaaaagk 
Arrow keys navigate the menu. <Enter> selects submenus --->. i x 
letters are . = P ing <Y> includes, <N> excludes, 
features. c>< Oo exit, ?> for Help, </> for 
ce  baskt-an <M> module > module capable 
« laqqqqqqaqaqaaas qaqqqaqaaag qaqaqaqaqaagqaqaqagqagaqagagagqaqagaqagqaqagqaqaaaagqagagk 
> [ ] Wirele LAN (pre-802 ) x 
] Wireless LAN 
Realt 


[ 
[ 
[ 
[ 
[ 


> 


Enable external 
Enable Tx Beamfo 


c 


> 


0 Enable Antenna 
Private buffer management 
Virtual Support 
Client Mode Support 
sd Repeater Mode support 1 
Repeater Mode support 
ne support 
Realtek wps2.0 support 
Band Edge Limit support for 92C/92D/88 
rt 
Filter 
support 
© mqqqqqqqqqaqqqqagaaaagaaaagagaaggagagaaaagagaagaaaagagaaaagagaqaagaaaaaaaaaaagagagy ! 
tqqqqqag qqqaqaaggaqqagqgag qqqaqqagqaqaagqaaqararaggaagaagaaggaggaagaaagaags§ 
x < Exit > < Help > 
maqqqaqgaggagraagaagaagaaqgaaqaagaraqarqgaaragagagaagaragaqagaggaaggagaraagaggaaaaaqaaas | 
~jj 
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When enabled wifi-direct need to turn system configuration 
(0x31000) linux image offset in flash. 


(0x160000) root image offset in flash. 


a a <C Dl 
(@ 172.2169.111 - Purty an = Sax 


qqqqaaarqaaaqaaaaaaaaqaaaaaagaqaaaaaaaaaaagaaaaaaaaaags 
nfiguration q q q q qqk 


uld be 


S88 Boot 3 e 
1(0x160000) root image flash. 
“~ Platfs image 3 d be 


qqgqaqq ¢ qaqqqag qa qaqgaqgagagg J 
qqaqqqaaaa qqqaqaqagggagggaaagas ¢ qqg qaqaqaaaqaaagaqaaraqaaqaagaaaaqaaagaaagagaqqgqu 
K<Select > Help 
qaqaaqac q q 
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Turn on P2P mode by set flash mib” flash set WLANO MODE 8”, or configure from web page as 


belowf 


}| @ http://192.168.1.2/homehtm + BG X || G Realtek WLAN AP Webse... 


te contents 
S ard 


Operation Mode 


Si 
3 
a 
7 


-Fi Direct 
@ TCP/IP Settings 
@ Firewall 
B Qos 
B Route Setup 
i Management 


WLAN Access Point 


Wireless Basic Settings 


This page is uséd to configure the parameters for wireless LAN clients which may connect to your 
Access Point. Here you may change wireless encryption settings as well as wireless network parameters. 


| Disable Wireless LAN Interface 


Band: 2.4GHz B+GiN) + 
Mode: PoP = 
(BP 
Network Type: [cient 
WDS 
SSD: |APsWDS 
Channel Wid: Lol 
Control 
Sideband: Upper» 
Channel ite 
Number: 


Broadcast SSID: Enabled wv 


um 
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ht] 


204 


192.168.1.2/home.htm 2 ~ BS X || S Realtek WLAN AP Webse... 


WLAN Access Point 


Site contents 
B Setup Wizard 
Operation Mode 


Wifi Direct 
Wi-Fi Direct, is a certification program from the Wi-Fi Alliance based on a set of software protocols (the Wi-Fi 


Peer-to-Peer specification) that allow Wi-Fi devices to talk to each other without the need for wireless aocess points 
thot spots). The Wi-Fi Direct certification program is developed and administered by the Wi-Fi Alliance, the 


B Basic Settings 
" e industry group that develops the standards suite underlying the Wi-Fi CERTIFIED certification program and owns 


the "Wi-Fi" trademark, 


BH Advanced 


Role: Device 
Status: Listen 


Force group owner 


Intent value: l4 + 
@ Firewall Listen channel: ll + . 
| 
B Route Setup Device Name: RTL8196E 
an Management Self-PIN Number: 33787506 


[Apply Changes | { Reset] 


None 


| Scan | Connect | | Back todevice mode | 


m r 


P2P control page as above fig 


-The check box “force to group owner” to switch DUT’s role to GO mode force,then push “apply 
change” button to apply. 


-change Intent value or listen channel or device name and push “apply change” button to apply. 
-The button “back to device mode” can force switch role to DEV mode 


-Under DEV mode push the button “scan” to do P2P discovery and result will list in the table of 
web page 


-After P2P discovery you choose some DEV or GO from discovery result and push the button 
“connect” to do P2P connect. 


When DUT under GO mode or DEV mode, DUT can do P2P connection by passive mode that 
without web UI intervened. 
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4.54Realtek Simple Config support 


Realtek Simple Config is a method to simplify the WLAN profile configuration procedure: Use 
APP on smart-mobile/tablet/PC... to assist Wi-Fi device to join the WLAN network. 


4.54.1 How to Enable Simple Config 
1) kernel configure 


make linux_menuconfig //To configure linux kernel 


Linux kernel menu as follows: 
Device Drivers ---> 
[*]Network device support ---> 
Wireless LAN ---> 
[*]RTL8192C/D 802.11b/g/n support 
[*] Realtek Simple Config Support 


2) user application configure 


WwW Wal’ 


//enter 

//selected and enter 
//enter 

//selected 
//selected 


make users_menuconfig //To configure user application 
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4.54.2 How to test Simple Config 
The device MUST on client mode, and the MIB SC_ENABLED MUST set to 1. 
Please refer to Android_Simple_Config_User_Guide_v0.x.pdf or 
IOS_Simple_Config_User_Guide_v0.x.pdf for more details. 


4.55 Realtek Bluetooth support 
Realtek Bluetooth BSP and Driver are supported by the SDK. 


For 96e, toolchain rsdk-4.4.7-4181-EB-2.6.30-0.9.30-m32u-140129(for kernel 2.6.30) or 
rsdk-4.6.4-418 1-EB-3.10-u0.9.33-m32-150324 (for kernel 3.10) should be used. 

For 96D/97D/8881A, toolchain rsdk-1.5.10-528 1-EB -2.6.30-0.9.30-m32ub-130429(for kernel 
2.6.30) or rsdk-4.6.4-528 1 -EB-3.10-0.9.33-m32ub-20141111(for kernel 3.10) should be used. 


Please decompress the toolchain tar ball at SDK toolchain directory. 


4.55.1 Enable Bluetooth Support 


Kernel menuconfig 
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stworking support ---> 


‘77 0FR4Z0M OM 


--- Networking support 
e 


OOVAZAADWDWHO LYS 


RF switch subsystem support for kernel 3.10: 


—-- RF switch subsystem support 
G 


Bluetooth subsystem support for kernel 3.10: 


-=- Bluetooth subsystem support 
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le 

R 

C*] RTK BT RFKILL 
R 


note: RTK HCI USB driver depends on USB support 


Bluetooth subsystem support for kernel 2.6.30: 


ant 


_P 


Bluetooth device drivers => 
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Users menuconfig: 
Select bluez and the bluetooth chip, 
For kernel 2.6.30, you should select bluez-4.96, for kernel 3.10, bluez-5.24 is preffered. 


RLX Linux Configuration 


pA CcwWDOH Sw 


Add mdev in by busybox menconfig if usb bluetooth used 
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L 
L 


| Linux System Utilities ---> 


4.55.2 Enable USB for USB Bluetooth Support 


USB config for XHCI (USB 3.0): 
[*] USB support ---> 


-5- USB support 
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USB config for EHCI/OHCI/OTG (USB 2.0): 
(For 96E, you should enable DWC_OTG support) 


--- USB support} 


s 


4.55.3 Enable UART for UART Bluetooth Support (now only 96e/97DL can support UART 


Bluetooth) 
Device Drivers ---> 
Character devices ---> 


Serial drivers ---> 


Note: Number of 8250/16550 serial port to register at runtime should be changed to 2 


[9] 819x RTL UART1 support 
s 


4.55.4 How to check if bluetooth work 
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If usb bluetooth chip used, the following command should be issued before bring the device up: 
echo /bin/mdev > /proc/sys/kernel/hotplug 
mount -t sysfs sysfs /sys 


echo | > /sys/class/firmware/timeout 


If uart bluetooth chip used, the following command should be issued to bring up the device: 
hciattach -n -s 115200 /dev/ttyS1 rtk_h5 115200 & 


verify by bluez command: 

hciconfig hci0 up 

hciconfig hci0 iscan /*can be seen by other bluetooth device */ 
hcitool scan = /*scan other bluetooth device*/. 


I2ping Xx:xx:xx:Xx:xx:xx /*if can ping through*/ 


4.56 Realtek bridge guest zone support(for kernel 3.10) 
4.56.1 How To enable bridge guest zone 

Kernel config 

[*] Networking support ---> 


Networking options ---> 


Enable RealTek Guest Zone| 
i 
Q 


OHUVUEFTAYYH ps 
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4.56.2 How to configure bridge guest zone 


commands: 
setzone <bridge> <device> <val> set zone type (0: host, 1: guest, 2: 
gateway) for interface 
setzoneisolate <bridge> <value> set zone isolation (0: no, 1: yes) 
setguestisolate <bridge> <value> set guest isolation (0: no, 1: yes) 


chkguestmac <bridge> <verb> <mac> check if mac addrs of client is come 
from guest zone 


setlockclient <bridge> <mac> set mac addrs of locked client list 
showguestinfo <bridge> show zone and locked client info 
setgatewaymac <bridge> <mac> set mac addr of gateway 


We divide all bridge ports to 3 kinds. The first one is host port. The traffic of devices connecting 
to host ports is not restricted. The second one is guest port. The traffic of devices connecting to 
guest ports is restricted to and from gateway only. The third one is gateway port. The gateway 


device is expected to connect to the gateway port. 


Using bret] utility with command “setzone” can set port type. For example, we assign SSID4 as 
guest port and we connect gateway device on eth0. The commands are: 

brctl setzone brO wlan1-va2 1 

brctl setzone br0O ethO 2 
Other ports that are not set are host ports by default. 


If we don’t wish the traffic communicated between host ports and guest ports, we can use 
command “setzoneisolate” to give restriction. The command is: 


brctl setzoneisolate brO 1 


If we don’t wish the traffic communicated between guest ports, we can use command 
“setguestisolate” to give restriction. The command is: 


brctl setguestisolate br0O 1 


Because we want to let device connecting to guest ports communicate with gateway device, but 
we don’t want to let device connecting to guest ports communicate with devices which are also 
connecting to the same port as gateway device, we need to know the MAC address of gateway 
device. Then if a packet is from guest port and going to gateway device, we will allow it. But if a 
packet is from guest port and going to other devices connecting to gateway port, we will drop it. 
Using command “setgatewaymac” to give the MAC address of gateway device: 

brctl setgatewaymac brO 001a92783ecf 
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There is also a command “showguestinfo” showing the settings or status. Using this command 
can get the current status: 
brctl showguestinfo br0 
The content printed is as following: 
zone isolation: | 
guest isolation: | 
ethO: gateway 
wlan0: host 
wlan1: host 
wlanO-va0: host 
wlanO-val: host 
wlan0O-va2: host 
wlan1-va0: host 
wlanl-val: host 
wlanl-va2: guest 
locked client no: 0 


gateway mac=00:1a:92:78:3e:cf 


The other two commands of “chkguestmac “ and “setlockclient” are not used in WLAN partition 


function. 


We take an example. In some kind of usage scenario, there are 4 SSIDs on 5G band and 4 SSIDs 
on 2.4G band. The device is configured as bridge mode. All Ethernet ports are configured as LAN, 
including ethO and eth1. A gateway device is connecting to ethl. We wish smart phones 
connecting to a restricted area, i.e. SSID4 and SSID8. These phones can communicate with 
gateway device, but can’t communicate with devices connecting to other SSIDs or ethO. For this 
kind of application, we can configure bridge module after bridge module is activated as 
following: 

brctl setzone brO wlan0-va2 1 

brctl setzone brO wlanl-va2 1 

brctl setzone br0 eth! 2 

brctl setzoneisolate br0O 1 

brctl setguestisolate brO 1 

brctl setgatewaymac br0 001a92783ecf 


4.57 2.4G -wlan0/5G-wlan1 Support(for kernel 3.10) 
Support 2.4G at wlan0 and 5G at wlan1l. 
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4.57.1 How To enable 2.4G -wlan0/5G-wlan1 
Kernel config 
Device Drivers ---> 
[*] Network device support ---> 
Wireless LAN ---> 
Select WiFi Band on Wlan0 (Select 2.4g band on wlan0)_ ---> 


(X) Select 2.4g band on wlan0 


Select WiFi Band on WlanOd 
Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
“Shs Geer lskelalicsemvall akimureyemiehealOim. tleeybic (elas) feyaiealenal, 


elect 2.4g band on wland 
Select 5g band on wland 


4.57.2 Howto Test 2.4G -wlan0/5G-wlanl 


In order to check whether 2.4G at wlan0, you can open Web UI or get wlan related mib value at 
AP console . 


4.58 IOL Test 
For RTL8198 platform: 


Set to test mode 1: echo test 1 > /proc/ phyRegTest 
Set to test mode 4 for port 0 ~ 4: echo test 4 [port] > /proc/ phyRegTest 


You need to reboot the DUT when you finish any one of 1000M test mode then redo next one. 


For RTL8198C platform: 
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Set to test mode 1: echo test 1 > /proc/ phyRegTest 
Set to test mode 4 for port 0 ~ 4: echo test 4 [port] > /proc/ phyRegTest 


Set to normal mode: echo test 0 > /proc/ phyRegTest 


For RTL8197D+RTL8367RB, RTL8881AB+RTL8367RB or RTL8197F+RTL8367RB 
platform: 


echo 8367test [phy_id] [test_mode] > /proc/rtl865x/phyReg 
phy_id: 0/1/2/3/4 
test_mode: 0/1/2/3/4 (0: normal mode; 1~4: test mode 1~4) 


If you want to change to different port, you need to set previous port to normal mode fist. 
For example: 

i) Ist power on 

il) phyid 3 test mode 1 

echo 8367test 3 1 > /proc/rtl865x/phyReg 

ili) phyid 3 test mode 4 

echo 8367test 3 4 > /proc/rtl865x/phyReg 

iv) before you change to phyid2, you must set phyid3 to normal mode 
echo 8367test 3 0 > /proc/rtl865x/phyReg 

v) phyid 2 test mode | 

echo 8367test 2 1 > /proc/rtl865x/phyReg 


For RTL8197F platform: 
Command: echo testIOL [port] [test_mode] > /proc/phyRegTest 
where port = 0 ~ 4, 
test_mode is one of the following string: 

"100_MDI", 

"100_MDIX", 

"100_finish", 

"10_MDI", 

"10_MDIX", 

"10_finish", 

"pktGen_allFF", 
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"pktGen_random", 


"pktGen_disable". 


4.59 Differential Voltage Test 
For RTL8198C platform: 
Command: echo testdv [level] > /proc/ phyRegTest 


where level = | or 2 or 3 or O (set to default value) 


4.60 NAND FLASH support 
4.60.1 nand flash support bootloader. 
example for 8198C: 
8198C nand flash board have it’s own independent bootloader config.just config the bootloader as 
<2.2 section> describe. The key config step describe blow: 
setp1: enter bootloader source code. 
step2: select config file: 
cp def-rtl8198c-8954e-nand-config .config 
step3: appoint toolchain: 
PATH=$PATH: ../rtl8 19x/toolchain/msdk-4.4.7-mips-EB -3.10-0.9.33-m32t-131227b/bin 
step4: run command: make menuconfig. Load the default config 
step5: choose ‘<Exit>’ and click ‘Enter’, save the new configration. than make. 


the bootloader for 8198C nand flash will generate in btcode/boot.bin 


example for 8197F: 

8197F support two type nand flash, spi nand and parallel nand . 

8197F nand flash board have it’s own independent bootloader config.just config the bootloader as 
<2.2 section> describe. The key config step describe blow: 


setp1: enter bootloader source code. 
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step2: select config file: 
cp def-rtl8197f-spi_nand-config .config //spinand 
cp def-rtl8197f-parallel_nand-config .config //parallel nand 
step3: appoint toolchain: 
PATH=$PATH: ../rtl819x/toolchain/ msdk-4.4.7-mips-EL-3.10-u0.9.33-m32t-140827/bin 
step4: run command: make menuconfig. Load the default config 
step5: choose ‘<Exit>’ and click ‘Enter’, save the new configration. than make. 


the bootloader for 8197F nand flash will generate in btcode/boot.bin 


4.60.2 compile nand flash support rlxlinux image. 


@ 8198C platform 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> includes, <N> 
excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


select components 

Selected Target (rt18198C_8954E) ---> 

Selected Kernel (linux-3.10) ---> 

Selected Busybox (busybox-1.13) SSS 

Selected toolchain (msdk-4.4.7-mips-EB-3.10-0.9.33-m32t-131227b) ---> 
rt18198c 

Selected Board Configuration (RTL8198C NAND) =Soh 

config components 

Config kernel 

Config users 


Save default settings 


Load an Alternate Configuration File 
Save an Alternate Configuration File 


sdk provide independent configration for nand flash 8198C board,just run command make 
menuconfig, select config like the picture above show, and select <load default setting > ,than make. the 
detail config process description same with <2.3 section>,I[mage will generate in folder image/ 
directory. you can upload image like the <3.3 section> describe. 


@ $197F platform 


1. select 97F nand as board configuration 
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RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> includes, <N> 
excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] excluded 
<M> module < > module capable 


--- select components 
Selected Target (rtl1B8197F) ---> 
Selected Kernel (linux-3.10) ---> 
Selected Busybox (busybox-1.13) ---> 
Selected toolchain (msdk-4.4.7-mips-EL-3.10-u0.9.33-m32t-140827) ---> 
SS Goel eal iy 
Selected Board Configuration (RTL8197F_NAND) ---> 
--- config components 
{ ] Config kernel 
{ ] Config users (NEW) 
[ ] Config busybox 
[ ] Save default settings 
Load an Alternate Configuration File 
Save an Alternate Configuration File 


< Exit > < Help > 


2. select nand flash type 
> SPINAND 
make linux_menuconfig 
--> Device Drivers 
--> Memory Technology Device (MTD) support 
--> NAND Device Support 
--> NAND FLASH Controller 


--> controller type (97F spi nand controller) 


> Parallel nand 
make linux_menuconfig 
--> Device Drivers 
--> Memory Technology Device (MTD) support 
--> NAND Device Support 
--> NAND FLASH Controller 


--> controller type (97F parallel nand controller) 


sdk provide independent configration for nand flash 8197F board,just run command make 
menuconfig, select config like the picture above show, and select <load default setting > ,than make. the 


detail config process description same with <2.3 section>,I[mage will generate in folder image/ 
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directory. you can upload image like the <3.3 section> describe. 

4.60.3 How to nand flash as storage 
Sometimes we need startup from spi nor flash , Nand flash exists as a storage device 
example for 97f platform(only support parallel nand) 


@ bootcode 


Please enable nand flash releate config based on spi nor flash defconfig 
cp def-rtl8197f-config .config 
make menuconfig 

[*] NAND FLASH SUPPORT 

(PARALLEL_NAND) NAND FLASH Type 

[*] Support Remap BBT (NEW) 

(800) Nand Flash Page Size (NEW) 


@ linux sdk 
please enable CONFIG_RTK_NAND_FLASH_STORAGE config 
make linux_menuconfig 
--> Device Drivers 
--> Memory Technology Device (MTD) support 
--> NAND Device Support 


--> nand flash as storage 


4.60.4 How to generate image for nand flash e-WriterPro 
Image for nand flash e-WriterPro is the image can be burned to nand flash directorly by nand 
flash e-WriterPro. the image generator tool location is <users/bch6_eccenc>,run command like below: 
First, compiler the image generate tool for nand flash e-WriterPro. 
a> cd users/bch6_eccenc 


b> make 
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c> image generator tool will generate with name “eccenc” 
second,generate image for nand flash e-WriterPro. 
d> prepare three files blow, copy the three files to the directory same with eccenc program. 
boot (note: not boot.bin, locate in rtl8 19x-bootcode-SDK-v3.4.7-98C/btcode/ directory), 
linux.bin (locate in rtl8 1 9x/image/ directory) 
squashfs.o (locate in rtl&19x/target/ directory). 
f> ./eccenc --chunk-size 2048 --chunk-per-block 128 -bso 23 -bdo 2000 boot 0 linux.bin 
3145728 squashfs.o 9437184 


g> the image for nand flash e-WriterPro will generate with name “burn.bin.ecc”’. 


4.61 IP-IN-IP SUPPORT 
4.61.1 How To enable IP-IN-IP 
Kernel config 
make linux_menuconfig 
[*] Networking support ---> 
Networking options ---> 
[*] IP: tunneling 


Users config 


make menuconfig 
[*] Config busybox 
Networking Utilities ---> 

[*] ip 
[*] ip address 
[*] ip link 
[*] ip route 
[*] ip tunnel 
[*] ip rule 

make users_menuconfig 


[]iproute2 ///disable iproute2 
4.61.2 How to configure ip-in-ip 
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LAN PC<---------- > DUT <------- Tunnel ------- > Ubuntu server 

DUT Confiure: 

ifconfig eth! dut_ip_addr 

ip tunnel add tun0 mode ipip remote server_ip_addr local dut_ip_addr 

ip link set tunO mtu 1400 up 

ip address add tun_dut_ip brd 255.255.255.255 peer tun_server_ip dev tun0 
route del default 

route add default gw tun_server_ip 

//set firewall to accept tunnel packet 

iptables -I INPUT -p 4 -j ACCEPT 

iptables -I INPUT -p icmp -j ACCEPT 

iptables -A FORWARD -p icmp -j ACCEPT 

iptables -A FORWARD -i tun0 -m state --state RELATED,ESTABLISHED -j ACCEPT 


ubuntu server configure: 

ifconfig ethl server_ip_addr 

ip tunnel add tun0 mode ipip remote dut_ip_addr local server_ip_addr 

ip link set tunO mtu 1400 up 

ip address add tun_server_ip brd 255.255.255.255 peer tun_dut_ip dev tun0 
route del default 


route add default gw tun_dut_ip 


4.61.3 How to test 
1. LAN PC ping tun_server_ip 


2. LAC PC run chariot to test thruput by tunnel encapsulation 


4.62 Realtek Giga Lite (Two-Pair 500Mbps) support (for kernel 3.10) 


For RTL8198C/RTL8198CS/RTL8954E/RTL8954ES SoC, the Realtek proprietary giga lite 
protocol allows the Ethernet port to link on 500Mbps instead of 100Mbp with two-pair cable. It 
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can only take effect when two link partners support this protocol. 
Disable giga lite in the release image: the giga lite default setting is disabled in the release SDK. 
Enable giga lite in the release image: please enable “Enable Giga Lite support” item. 
Path: make linux_menuconfig 
-> Device Drivers 
-> Network device support 
-> Options for Realtek SoC 


-> Enable Giga Lite support 


Enable/disable giga lite in the run time stage: 
Enable: echo gigalite 1 > /proc/rtl865x/phyReg 
Disable: echo gigalite 0 > /proc/rtl865x/phyReg 


Link speed check: use “cat /proc/rtl865x/port_status” console command to check the link speed is 
10M, 100M, 500M or 1 Gbps.. 


4.63Https boa support 
4.63.1 How To enable https boa 
make users_menuconfig 


[*] boa 
[*] boa SSL Support 


select boa SSL Type (BOA with mbedtls) — ---> 


J 

J boa CGI Support 

] boa IPv6 Support 

J boa new UI Support 

J boa multi-users Support 
J] system diagnostic 

1] digest authentication 


select boa SSL Type CBOA with mbedtls) ---> 
Select the SSL library that is required. At this moment, mbedtls-2.2.1 and openssl]-0.9.8i are 
supported. 
4.63.2 How To Generate a certificate 
1) download ssl.ca-0.1.tar.gz 


2) # tar zxvf ssl.ca-0.1.tar.gz 
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3) # cd ssl.ca-0.1 

4) # ./new-root-ca.sh 
No Root CA key round. Generating one 
Generating RSA private key, 1024 bit long modulus 
Sasatustespmoakateabcusabnas t+++4++ 
seb ttt+ 
e is 65537 (0x10001) 
Enter pass phrase for ca.key: (enter password) 
Verifying - Enter pass phrase for ca.key: (verify password) 
Self-sign the root CA... 


Enter pass phrase for ca.key: (enter password) 


Country Name (2 letter code) [MY]:CN 

State or Province Name (full name) [Perak]:JS 

Locality Name (eg, city) [Sitiawan]:SZ 

Organization Name (eg, company) [My Directory Sdn Bhd]:AAA 
Organizational Unit Name (eg, section) [Certification Services Division]: AAA 
Common Name (eg, MD Root CA) []: AAA 

Email Address []:aa@aa.com 


5) # ./new-server-cert.sh server 


Country Name (2 letter code) [MY]:CN 

State or Province Name (full name) [Perak]:JS 

Locality Name (eg, city) [Sitiawan]:SZ 

Organization Name (eg, company) [My Directory Sdn Bhd]: AAA 


Organizational Unit Name (eg, section) [Secure Web Server]: AAA 
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Common Name (eg, www.domain.com) []: AAA 
Email Address []:aa@aa.com 
6) # ./sign-server-cert.sh server 
CA signing: server.csr -> server.crt: 
Using configuration from ca.config 
Enter pass phrase for ./ca.key: (enter password) 
Check that the request matches the signature 
Signature ok 
The Subject's Distinguished Name is as follows 
countryName :PRINTABLE:'CN' 
stateOrProvinceName  :PRINTABLE:'JS' 
localityName :PRINTABLE:'SZ' 
organizationName :PRINTABLE:'AAA' 
organizational UnitName:PRINTABLE:'AAA' 
commonName :PRINTABLE:'AAA' 
emailAddress S[ASSTRING:'aa @aa.com' 
Certificate is to be certified until Jul 16 12:55:34 2005 GMT (365 days) 
Sign the certificate? [y/n]:y 
1 out of 1 certificate requests certified, commit? [y/nly 
Write out database with | new entries 
Data Base Updated 
CA verifying: server.crt <-> CA cert 
server.crt: OK 
7) Copy server.key &server.crt to ~/users/boa/, and rename to privateKey.key &certificate.crt. 


8) build image 


4.64exfat-fuse file system 


4.64.1 How To enable exfat-fuse 


make linux_menuconfig 


[*] FUSE (Filesystem in Userspace) support 
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I 
EF 
Q 
Ki 


[ye] FUSE (Filesystem in Userspace) support 
Cc 
Cc 
c 


make users_menuconfig 
[*] exfat-fuse 


| File system Configuration 


d 
£ — 
[ie] exfat-fuse 


F 


[*] fuse library 


| Libraries Settings 


£ 
Fuse library 
L 
1 
z 


4.64.2 How To mount exfat-fuse 


mkdir /tmp/usb/sdal 
mount.exfat-fuse /dev/sdal /tmp/usb/sdal 


4.65exfat-nofuse file system 


4.65.1 How To enable exfat-nofuse 


make linux_menuconfig 
File systems ---> 
DOS/FAT/NT Filesystems ---> 
[*] exFAT fs support 
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4 MG*G" OGG" G*E"E"O"G"G"E"a"a"a*a*a*a* G*G*O*G*O*A"*C*a"*a*a"*a*a 


[ew] exFAT fs support 


4.65.2 How To mount exfat-fuse 


mkdir /tmp/usb/sdal 
mount -t exfat /dev/sdal /tmp/usb/sda1 


4.66 UART support 


4.66.1 UART1 support 
Config method: 


make linux_menuconfig 


Device Drivers ---> 
Character devices ---> 


Serial drivers ---> 


---> Select 819x RTL UART1 support 
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<*> 8250/16550 and compatible serial support 
Ea Support 8250 core.* kernel options (DEPRECATED) 
[*] Console on 8250/16550 and compatible serial port 
(2) Maximum number of 8250/16550 serial ports 
(2) Number of 8250/16550 serial ports to register at runtime 
[ ] Extended 8250/16550 serial driver options 
<*> Support for Synopsys DesignWare 8250 quirks 
819x RTL UART1 support (NEW) 
Select UART1 PINMUX (PO TXDO + PO TXC + PO TXCTL + PO RXCTL) ---> 
819x RTL UART2 support (NEW) 
MAX3100 support 
MAX310X support 


SCOCNYD earisal nart ennnare 


NevrAes 
c— vo 


---> Select UART1 PINMUX 


Select UART1 PINMUX 
Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
<?> for additional information about this option. 
lqaqqqqqqqqqgqqggaqaqgaaggqqqgggqaqgaagaaqgqggqgqgqagaaagdqgqgqgggqagaaaaaqaaag 
}(X)[MPO TXDO + PO TXC + PO TXCTL + PO RXCTL 
( ) MMC_DATO + MMC DATi + MMC DAT2 + MMC _DAT3| | 


qqgqqqqqaaaqagaaagaggaggagqaaaaaaaagaaaagggagagggaaaaaaaaaaaaaaagagaagaags 


Test Method: 
a) Find an pc use tools such as SecureCRT connected with DUT uartlon pc, choose 
an baudrate such as 38400. 
b) Enter command on DUT : stty —F /dev/ttyS1 38400 (the baudrate you set) 
c) Enter command on DUT: echo “any world you enterd” > /dev/ttyS1 
d) Check SecureCRT if can get the right(any world you enterd) world you enterd on 
DUT 
How to config stty: 
Make menuconfig: 
Config busybox ---> 
Coreutils ---> 
[ ] stty 


4.66.2 UART2 support 
Config method: 
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make linux_menuconfig 


Device Drivers ---> 
Character devices ---> 
Serial drivers ---> 
Note: 
1. Maximum number of 8250/16550 serial ports should be changed to 3. 
2. Number of 8250/16550 serial port to register at runtime should be changed to 3. 


---> Select 819x RTL UART2 support 


(3) Maximum number of 8250/16550 serial ports 
(3) Number of 8250/16550 serial ports to register at runtime 
{[ ] Extended 8250/16550 serial driver options 
<*> Support for Synopsys DesignWare 8250 quirks 
{*] 819x RTL UART1 support (NEW) 
Select UART1 PINMUX (PO TXDO + PO TXC + PO TXCTL + PO RXCTL) ---> 
819x RTL support (NEW) 
Select UART2 PINMUX (PO RXDO + PO RXDi + PO RXD2 + PO RXD3) ---> 
< > MAX3100 support 
{ ] MAX310X support 


---> Select UART2 PINMUX 


Select UART2 PINMUX 


Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
<?> for additional information about this option. 
lqaqaqaqaaaaaagagaaaqagagaggqggagagagagagagagagagagagagagagaaaaqaqaqaqag 
PO RXDO + PO RXD1 + PO RXD2 + PO RXD3 
(_) MMC_DATO + MMC DAT1 + MMC DAT2 + MMC _DAT3| | 


qqqqdqaqagqqqdaqaggqgqqqaaaggggqqagaaagggqqagagggggqqaaaggggqaaaagagaaqaaas 


4.67 System Memory size > 256MB support (98C only) 


m@ Ifthe memory size of you platform is bigger than 256MB, for eample 512MB, then 
you should follow below steps to enable high memory support in the kernel 
menuconfig. 


Step1: Enable High Memory Support in kernel_menuconfig 
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System Configuration ---> 
[* ] Supoort System Memory bigger than > 256MB 


Kernel type > 
(*1 High Memory Support 
[ } Enable bounce buffers 
4.68 Hardware Crypto Engine API support 
4.68.1 How to enable Hardware Crypto Engine API 
Enable “Driver Realtek Crypto Engine” in linux_menuconfig 


Location: 
->Cryptographic API 


-> Hardware crypto devices 


-> [*] Driver Realtek Crypto Engine 


Hardware Crypto Engine API already been hooked with Linux Cryptographic API 


framework. 


Application based on Hardware Cryptographic API framework can be automatically 
accelerated by Hardware Crypto Engine. 


Supported Linux Cryptographic API list as following: 
CONFIG_C CRYPTO_HMAC 

CONFIG_C CRYPTO_HASH 

CONFIG_C CRYPTO_ALGAPI 

CONFIG_C CRYPTO_BLKCIPHER 

CONFIG_C CRYPTO_CBC 

CONFIG_C CRYPTO_CTR 

CONFIG_C CRYPTO_ECB 

CONFIG_C CRYPTO_MD5 

CONFIG_C CRYPTO_SHA1 


CONFIG_C CRYPTO_AES 


CONFIG_C CRYPTO_DES 
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Note: 


1) Linux Cryptographic API guide can be found in Linux kernel official documentation 


directory located at linux-3.10/Documentation/crypto/. 


2) Some application based on Linux Cryptographic API framework(eg: strongS wan) 


be seamless accelerated by hardware crypto engine. 


4.68.2 Supported Crypto type 
1) “md5” 
2) “shal” 
3) “ecb(des)” 
4) “ecb(des3_ ede)” 
5) “ecb(aes)” 
6) “cbe(des)” 
7) “cbe(des3_ede)” 
8) “cbc(aes)” 


9) “ctr(aes)” 


4.68.3 Hardware Crypto Engine API 


int32 rtl_ipsecEngine (uint32 modeCrypto, uint32 modeAuth, 


uint32 cntScatter, rtl_ipsecScatter_t *scatter, void *pCryptResult, 


uint32 lenCryptoKey, void* pCryptoKey, 
uint32 lenAuthKey, void* pAuthKey, 
void* plv, void* pPad, void* pDigest, 
uint32 a2eo, uint32 enl) 


Description: 


—hardware crypto engine API for encryption or decryption or authentication. 


Parameters: 


@modeCrypto: input parameter, crypto mode, defined in rtl_ipsec.h. 


DECRYPT_CBC_DES 


0x00 


DECRYPT_CBC_3DES 


0x01 
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DECRYPT_ECB_DES Ox02 
DECRYPT_ECB_3DES 0x03 
ENCRYPT_CBC_DES 0x04 
ENCRYPT_CBC_3DES 0x05 
ENCRYPT_ECB_DES 0x06 
ENCRYPT_ECB_3DES 0x07 
DECRYPT_CBC_AES 0x20 
DECRYPT_ECB_AES 0x22 
DECRYPT_CTR_AES 0x23 
ENCRYPT_CBC_AES 0x24 
ENCRYPT_ECB_AES 0x26 
ENCRYPT_CTR_AES 0x27 


@ modeAuth: input parameter, authentication mode , defined in rtl_ipsec.h. 


HASH_MD5 0x00 
HASH_SHAI Ox01 
MAC_MD5 Ox02 
MAC_SHA1 0x03 


@ cntScatter: input parameter, number of rtl_ipsecScatter_t. 

@ scatter: input parameter, point to the data to be encrypt or decrypt or authenticate, must 
be un-cached address. 

@ pCryptResult: output parameter, point to the encrypt or decrypt result buffer, must be 
un-cached address. 

@ lenCryptoKey: input parameter, the encrypt or decrypt key length. 

@pCryptoKey: input parameter, point to the encrypt or decrypt key buffer, must be 
un-cached address. 

@ lenAuthKey: input parameter, the authenticate key length. 

@ pAuthKey: input parameter, point to the authenticate key buffer, must be un-cached 
address. 

@ plv: input parameter, point to the IV buffer, must be un-cached address. 

@ pPad: input parameter, point to the padding buffer, must be un-cached address. 


@ pDigest: output parameter, point to the hash result buffer, must be un-cached address. 


Example code : 
#if !defined(CRY PTOTEST_USE_UNCACHED_MALLOC) 
static uint8 _cryptoKey[32 + 32 + 32]; // 32 for AES-256 
static uint8 _cryptolv[32 + 16 + 32]; // 16 for AES 
static uint8 _asic_orig[32 + MAX_PKTLEN + 32]; 
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static uint8 _asic_enc[32 + MAX _PKTLEN + 32]; 
static uint8 *cryptoKey, *cryptolv; 

static uint8 *asic_orig, *asic_enc; 

#endif 

rtl_ipsecScatter_t scatter[1]; 

char *key = "\x06\xa9\x21\x40\x36\xb8\xal\x5b" 
"\x5 1\x2e\x03\xd5\x34\x12\x00\x06"; 

int klen = 16; 

char *iv = "\x3d\xaf\xba\x42\x9d\x9e\xb4\x30" 
"\xb4\x22\xda\x80\x2c\x9 fixac\x4 1"; 

char *input = "\xe3\x53\x77\x9c\x 10\x79\xae\xb8" 
"\x27\x08\x94\x2.d\xbe\x77\x18\x1a"; 

int ilen = 16; 

char *result = "Single block msg"; 

AES_KEY aes_key; 

uint32 sawb = 0; 


uint8 *asic_result; 


SMP_LOCK_IPSEC; 

rtl_ipsecGetOption(RTL_IPSOPT_SAWB, &sawb); 

#if !defined(CRYPTOTEST_USE_UNCACHED_MALLOC) 
cryptoKey = (void *) UNCACHED_ADDRESS(&_cryptoKey[32]); 
cryptolv = (void *) UNCACHED_ADDRESS(&_cryptolv[32]); 
asic_orig = (void *) UNCACHED_ADDRESS(&_asic_orig[32]); 
asic_enc = (void *) UNCACHED_ADDRESS(&_asic_enc[32]); 
#else 

rtl_ipsecTest_Init(); 

#endif 

AES_set_encrypt_key(key, klen*8, &aes_key); 

memcpy((void *) cryptoKey, &aes_key.rd_key[4*10], 16); 
memDump(aes_key.rd_key, 11*4*4, "key"); 


memcpy(cryptoly, iv, 16); 


memcpy(asic_orig, input, ilen); 
scatter[O].len = ilen; 
#if 0 


scatter[0].ptr = input; 
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#else 

memcpy(asic_orig, input, ilen); 
scatter[0].ptr = asic_orig; 
#endif 


g_rtl_ipsec_dbg = 1; 

rtl_ipsecEngine(0x20, -1, 1, scatter, asic_enc, 

klen, cryptoKey, 

0, NULL, 

cryptolv, NULL, NULL, 

O, ilen 

)s 

g_rtl_ipsec_dbg = 0; 

if (sawb)// use sawb, ASIC write back to scatter buffer 
asic_result = scatter[0].ptr; 

else// not use sawb, ASIC write to continuous buffer pCryptResult 
asic_result = asic_enc; 

/Af (memcmp(scatter[0].ptr, result, ilen) == 0) 

if (memcmp(asic_result, result, ilen) == 0) 

printk(""aes test vector success! \n"); 

else 

printk(""aes test vector failed!\n"); 
SMP_UNLOCK_IPSEC; 


Note: 
For more example code in kernel space, please refer to 


Linux-3.10/drivers/crypto/realtek/cry pto_engine/rtl_ipsec_test.c. 


4.69Apple WAC support 


Apple’s Wireless Accessory Configuration feature is designed to allow consumers to simply set 
up their wireless accessories with the network credentials already stored on their iOS or OSX device. 


Pre-existing MFi hardware is necessary. 


For Linux SDK 3.4.11, Apple WAC is supported by 8871A, 96E_88E, 97F_8812BR_8367R. 


4.69.1 How To enable WAC 


1. For Linux SDK 3.4.11: 
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Select corresponding board type and load default settings will be enough. 
For 96E_88E: 


make menuconfig 


Selected Board Configuration (96E+88E AP} ---> 


For 8871A: 


make menuconfig 


elected Board Configuration (8881AM WAC/HAP) ---> 


For 97F_8812BR_8367R: 
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--- select components 
Selected Target Crtl8197F) ---> 
Selected Kernel Clinux-3.1@) ---> 
Selected Busybox Cbusybox-1.13) ---> 
Selected toolchain Cmsdk-4.4.7-mips-EL-3.1@-u@.9.33-m32t-14@827) ---> 

--- rtl8197F 

--- config components 

[ ] Config kernel 

[ ] Config users 

[ ] Config busybox 

[*] Load default settings 

[ ] Save default settings 


Load an Alternate Configuration File 


2. For other Linux SDK: 


make linux_menuconfig 


[*] Networking support ---> 
Networking options ---> 
[*] The IPv6 protocol  ---> 


Networking options 

Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > module 
“@*R@ Gl -)@*R*R*S*E**E* AREA RAR ABABA BEBE BeBe BeBe’ 
IP: ESP transformatio 
IPR ADelCkenijey jerereuafehe(oyeitetic aie) 
IP: IPsec transport mode 
IP: IPsec tunnel mode 
IP: IPsec BEET mode 
Large Receive Offload (ipv4/tcp) 
INET: socket monitoring interface 
TGP! advanced congestion control —-——> 

i = i (RFC2385) 


SS 


(EXPERIMENTAL) 


Security Marking 
Network packet filtering framework 


x 


fe ey 


(Netfilter) ---> 


Device Drivers ---> 
Character devices. ---> 
Serial drivers  ---> 


[*] Support I2C-GPIO Driver for MFi Coprocessor 
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Serial drivers 


Arrow keys navigate the menu. <Enter> selects submenus -—-->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 


for Search. Legend: [*] built-in [ ] excluded <M> module < > module 
“Q*°A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A*E*E*E*E*E*E*E*E*E*E*G% 
[*] 8250/16550 and compatible serial support 
eee) Console on 8250/16550 and compatible serial port 
(29) Maximum number of 8250/16550 serial ports 
tls) Number of 8250/16550 serial ports to register at runtime 
{ ] Extended 8250/16550 serial driver options 


Support I2C-GPIO Driver for MFi Coproce 


Device Drivers ---> 
[*] Network device support ---> 
Wireless LAN ---> 


[*] Wlan event indicate support 


wireless LAN 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


Cian ony 


a Repeater Mode support 


multiple Repeater Mode support 

Client Mode 802.1x Support 

Multiple AP profile Support 
WDS Support 
Efuse Support 
WAPI Support 
Config File support 
Wireless Tools v29 support 
Realtek P2P support 
Realtek wps2.0 support 
Band Edge Limit support for 92C/92D/8812/88E/92E/8881A 
Use kernel thread to process TX power tracking 
RTL Mesh Support 
RTL A4 STA Support 
Realtek HS2.0 support 
Monitor mode support 
TDLS Support 
Realtek Simple Config Support 
*] IEEE 802.11W Support 


[gy] Wlan event indicate suppor 


L +) 


+ 


+ 


+ 


+ 


+ 


< Exit > < Help > 


make users_menuconfig 


System Configuration  ---> 
[*] Apple WAC Support 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > module 


dnsmasq 


Multi PPPok Support 


[*] rtk_event daemon 
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KLA Linux Conriguration | 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
{[*] built-in [ ] excluded <M> module < > module capable 
(-) 
oray ddns 
] pathsel 
*] pppd 


] IPv6 over PPP support 
] pppoe _disc flow _patch 
ppp reject error session patch 


*] firmware write daemon 
*] xtk_cmd daemon 
samba support ---> 
+] scripts 
*] squashfs 4.0 
] snmp 
] trod69 
] traceroute 
*] udhcp 
i ‘- (+) 


<Exit> </Help > 


make menuconfig 


[*] Config busybox 
Networking Utilities ---> 
[*] Enable IPv6 support 
[*]  ping6 


Networking Utilities 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
TOP Sseakeh. Legend: [*] built-in [ ] excluded <M module < > module 
A*OA*O*A*CE*E*A*A*A*A*A*A*E*E*E*E*E*A*A*A*A*A*E*E*A*E*E*A*A*R* A A*E*E*E*G* 
[mg] Enable IPvé 
T*] ~reterentially use IPv4 addresses from DNS queries (NEW) 
{[ ] erbose resolution errors 


Networking Utilities 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > module 


eS OTG| -) AQAA A*E*A*A*A*A*A*A*R*A*A*A*A*A*A*A*A*A*A*A*A*A*A*A* A A* Ar A* Aral 


upport displaying rarely used link types 


4.69.2 How to test WAC 
1. Wlan Configration: Mode~AP  Encrypt~disabled 


2. First your iphone or MacBook connect to a remote AP. 
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3. Site survey the AP with your iphone or MacBook. 
4. Click next. 


If WAC finished, the AP will change to client or repeater mode and connect to the remote AP, and 


your iphone or Macbook will display successful message. 


4.70 Apple HomeKit support 


Apple’s HomeKit allow consumers to communicate with and control connected accessories in the 


home. You can enable users to discover HomeKit accessories in their home and configure them, or you 
can create actions to control those devices. 


Pre-existing MFi hardware is necessary. 


4.70.1 How To enable HomeKit 
You should enable WAC before Homekit. 


make linux_menuconfig 


System Configuration ---> 
[*] Apple MFi program support 
[*] | Apple Homekit mtd block support 


System Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > module 
“@° O° R*R* ARE B*R*E* BRE B*R*E* BRE ARAB A*E* BREA AAA A*e*e*e* a 
System Type (96D+92D GW) ---> 
Enable watchdog timer support 
Support RTL8367R for RTL8881A 
Support RTL8211F for RTL8881A 
] Enable timer adjustment support 
] Webpages in rootfs support 


make users_menuconfig 


System Configuration ---> 
[*] Apple WAC Support 
[*] | Apple Homekit Support 
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RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
nee felersiiarcllas Legend: [*] built-in [ ] excluded <M> module < > module 


dnsmasq 


a 


Support 
a Sine 


ices (Homekit Switch Service) ---> 


4.70.2 Howto Test HomeKit 


In order to user homekit, the AP and your MacBook should connect to the same remote AP. 


With Apple’s software HAT, you can discover and configure the AP. 


4.71 rtl_fs support 


rtl_fs is Realtek proprietary high performance file-system supporting for NTFS, exFAT and HFS+ 


volume. It will be built as a module and automatically inserted into your kernel when your system was 
booted up. 


How to enable rtl_fs? There are three parts of options you need to configure. 
1. For kernel: 

make linux_menuconfig 

-> [*] Enable loadable module support 


->[*] | Module unloading 
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Enable loadable module support 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


--- Enable loadable module support 
bod Forced module loading 

= Module unloading 

] Forced module unloading 

] Module versioning support 

] Source checksum for all modules 
] Module signature verification 


[ 
[ 
[ 
[ 
[ 


< Exit > < Help > < Save > < Load > 


2. For users: 


make users_menuconfig 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 


reload 

dina_dms 

802.11 

minidlna 

mt—daapd 

sigma utils 

Load an Alternate Configuration File 
Save an Alternate Configuration File 


<mat> <Heip > 


3. For busybox command: 


Linux Module Utilities ---> 
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[*] | insmod 
[*] | rmmod 


[*] | lsmod 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[“] built-in [ ] excluded <M> module < > module capable 


efault directory containing modules 
efault name of modules.dep 
implified modutils 
insmod 
mmod 
smod 
retty output 
m dprobe 
epmod 
--- Options common to multiple modutils 
[ ] upport version 2.2/2.4 Linux kernels 
[ ] upport tainted module checking with new kernels 


ee ee 


4.72 STA Control support 


STA Control is Realtek proprietary feature, that works on dual-band platform. It detects whether a 
wireless client is dual-band capable, and if it is, steer the client to the pre-configured prefer-band. To 
enable this feature, please select the “Sta Control Support“ in menuconfig, as following demonstrated. 


Select “Config kernel” 


RLX Linux Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters 
are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press 
<Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] built-in [ ] 
excluded <M> module < > module capable 


--- select components 
Selected Target (rt18198) ---> 
Selected Kernel (linux-2.6.30) ---> 
Selected Busybox (busybox-1.13) ---> 
Selected toolchain (rsdk-1.3.6-5281-EB-2.6.30-0.9.30) ---> 
--- £rt18198 
Selected Board Configuration (AP - SPI flash, Squashfs) ---> 
Ic Test Configuration ---> 
--- config components 
] Config kernel 
] Config users 
] Config busybox 
] Load default settings 
] 
+ 


Save default settings 
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, and then exist. 
Select option of “Device Drivers”->“Network device support”->“Wireless LAN”, you would see 


bellow figure. 


ta Control Suppor 


Make sure “Sta Control Support” is selected. Compile SDK to generate new image. 


After the new image is uploaded, an “Enable STA Control” check box would appear in the 
WLAN |] advanced setting page. 
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ash REALTEK 


WLAN Access Point 


BASIC SETTING 
Fragment Threshold: [2346 (256-2346) 
RTS Threshold: [2347 (0-2347) 


Beacon Interval: fioo (20-1024 ms) 
TAPP: @eEnabled ODisabled 
Protection: Ocnabled © Disabled 
Aggregation: @eEnabled ODisabled 
Short GI: @®eEnabled ODisabled 
WLAN Partition: Oenabled Disabled 
STBC: @eEnabled ODisabled 
WPS LDPC: @eEnabled ODisabled 


TX Beamforming: @eEnabled ODisabled 
Mutilcast to Unicast: @eEnabled ODisabled 


TDLS Prohibited: O€nabled ©@Disabled 


TDLS Channel Switch 
Prohibited Ocnabled © Disabled 


SCHEDULE 


RF Output Power: O50% O35% O©O15% 
1 Enable STA Control 


Apply Changes | Reset | 


After checking the “Enable STA Control” option and selecting the prefer-band, please apply changes 
and reboot the device. 

In order to have the STA Control function work properly, please make sure the SSID and security 
setting for both WLAN1 and WLAN2 are same. 
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4.73 802.11r/k support 


802.11r 


802.111 introduces a new concept of roaming where the initial handshake with the new AP is done 


before the client roams to the target AP. The initial handshake allows the clients and APs to do the 


PTK calculation in advance. This mechanism allows time-consuming operations to be removed from 


the time critical re-association process. 


To enable this feature, select “Config kernel”-> “Device Drivers”->““Network device 
support”->“Wireless LAN” 


Wireless LAN 

Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <¥> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> £ 
Help, </> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


HOST Clock Source, Select is 40MHz, otherwise 25MHz 
Device Clock Source, Select is 40MHz, otherwise 25MHz 
Band Edge Limit support 
Use kernel thread to process TX power tracking 
RTL Mesh Support 
Support Cross-Band Access 
RTL A4 STA Support 
Enable WLAN DoS Filter 
Realtek HS2.0 support 
Monitor mode support 
TDLS Support 
Sta Control Support 
Realtek Simple Config Support 
TEEE 802.11K Support 
IEEE 802.11 Support 


»11R Support 
Select WiFi Band on WlanO (Select Sq band on wlanO) ---> 


co BkLGe < Help > < Save > < Load > 


Make sure both “IEEE 802.11R Support” is selected. 


Besides, select option of Users”->” openssl”->”openssl-0.9.8b” 


RLX Linux Configuration 

Arrow keys navigate the menu. <Enter> selects submenus --->. H 

letters are hotkeys. 

features. 

built-in 
*(—) 


ntpelient 
NFS utility 


Pressing <Y¥> includes, <N> excludes, <M> m 


Press <Esc><Esc> to exit, <?> for Help, </> for Searc 
{ ] excluded <M> module < > module capable 


Choose openssl version. 
openssl (openss1-0.9.8b) ---> 
wapi_utils (NEW) 

oray ddns 
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and select option of ’Users”->” FT Daemon support” 


Ca] T Daemon support 


Compile SDK to generate new image. 
After the new image is uploaded, the fast roaming related options are in the advanced menu. 


Support Over-the-DS: @ Enabled ‘ Disabled 


i oe 
RTS Threshold: [2347 (0-2347) 
[_apvanceo | Beacon Interval: fico t™* (20-1024 ms) 
Preamble Type: Long Preamble ‘ Short Preamble 
TAPP: Enabled ‘ Disabled 
Protection: © Enabled © Disabled 
Aggregation: @ Enabled © Disabled 
Short GI: @ Enabled ‘ Disabled 
WLAN Partition: C Enabled @ Disabled 
STBC: @ Enabled ‘© Disabled 
eines LDPC: Enabled ‘ Disabled 
20/40MHz Coexist: © Enabled @ Disabled 
TX Beamforming: Enabled Disabled 
Mutilcast to Unicast: = © Enabled Disabled 
TDLS Prohibited: © Enabled © Disabled 
ee oe fo - Bo 
RF Output Power: 100% © 70% 50% 35% 15% 
— aod ee © cee C ee 


Apply Changes Reset | 


When enables the “Support Over-the-DS”, the LAN of access points needed to be connected by cable, 


or roaming by Over-the-DS will fail. Besides, the “Support Over-the-DS” works only when “Fast BSS 
Transition Support” is enabled. 


802.11k 
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802.11k is an assisted feature that can as well reduce the time requied to roam. By providing neighbor 
AP list and their channel to clients, it allows clients to quickly determine which AP it should roam next. 
Clients do not need to probe all channels to find candidate AP for roaming. 

To enable this feature, select “Config kernel”-> “Device Drivers”->““Network device 
support”->“Wireless LAN” 


802.11K Support 


Make sure both “IEEE 802.11K Support” is selected. 


Besides, select option of ’Users”->” 11k Deamon support” 


F’ 
Ci] 11k Deamon support| 
u 


Compile SDK to generate new image. 
After the new image is uploaded, an “802.11k Support” option would appear in the WLAN 


advanced setting page. 
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anf, REALTEK 


SIC SETT 
Fragment Threshold: 2346 (256-2346) 
ADVANCED RTS Threshold: jesa7 (0-2347) 
Beacon Interval: [100 (20-1024 ms) 
Protection: OCeEnabled © Disabled 
Aggregation: @Enabled © Disabled 
Short GI: @®Enabled © Disabled 
WLAN Partition: OeEnabled © Disabled 
} mest serning STBC: @®eEnabled © Disabled 
MESH SETTIN 
LDPe: @®Enabled © Disabled 
TX Beamforming: @Enabled © Disabled 
Mutilcast to Unicast: @®Enabled © Disabled 
WPS 


RF Output Power: © 100% O70% O50% O35% O©O 15% 
: Enabled © Disabled 
Enable STA Control | Prefer 2GHz ¥ 


Apply Changes | Reset | 


SCHEDULE 


After enabling the “802.11k Support” option, please apply changes and reboot the device. 


4.74 VOIP menuconfig 
1. Introduction 


This intro user getting started with Develop VoIP Support for rtl89xxE board. The following 
sections describe menuconfig setting for board and VoIP configuration, Here is an ATA configuration 


example for “RTL89xxE” board. Please use command “make menuconfig” to select blow items: 


Main menuconfig: 


Selected Target (rtl89xxE) -—> 

Selected Kernel (linux-3.10) ---> 

Selected Busybox (busybox-1.13)) --—> 

Selected toolchain (msdk-4. 4. 7-mips—EB-3. 10-0. 9.33-m32t-131227b) ---> 


Selected Board Configuration (RTL8954E+8812+92E+VolP GW) -—--> 
[*] Config kernel 

[*] Load default settings 

<Exit><Save> 


linux menuconfig: 
RTK VoIP Suite ---> 
Please refer to your HW design, there are two SLIC IC we’ ll support: Silab and 


MicroSemi(Zarlink) 
Silab: 
RTK AP router is already support and test SI32171, 174, 176 on our QA board, and the driver lib 


is proslic_api-v7.3.2 (June, 2015), if you use SI3217x series, please choose as follows: 
RTK VoIP Suite ---> 
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[+] Si lab 
Le] $13217x 
##* §13217x options *** 
$13217x BOM (LCQC) ---> 
This is the SLIC HW DC-DC structure, please consult the vendor 


[x] $13217x support wideband 
*&* §13217x family SLIC select *** 
[¥] $13217x (Chip Select) 
$13217x use SPI type (Hardware) —-—> 
(1) $13217x number (Chip Select) (NEW) 


This is the 3217x IC numbers on your board 

(0) $13217x use PIN_CS# (Chip Select) (NEW) 

This is default 0 

[ ] $132176 (Daisy Chain) (NEW) 

If you use two or more 32176 IC and the DC-DC structure is Daisy chain, please choose this one 
[ ] $132178 (Chip Select) (NEW) 

[ ] multiple $132176 + single $132178 (Daisy Chain) (NEW) 

[ ] $13226 (QCUK) (NEW) 

Lil $13226x (FB) (NEW) 


(1) Control channel number 
This is the phone port numbers on your board, $13217x has one port 
MicroSemi (Zarlink): 


RTK AP router is already support and test LE88601, 89116, 89316 on our QA board, and the 
driver lib is api_lib-2.24.0 (June, 2015), if you use LE series, please choose as follows: 


Take 89116*1 + 89316*1 for example 


[x] Zar | ink 

[ ] LE88221 

[ ] LE9662 

[ ] LE88601 

[ ] LE88111 

[x] LE89116 

[ J Use LE89156 Board (NEW) 
[x] LE89116 support wideband 
(1) LE89116 number (NEW) 


This is the 89116 IC numbers on your board 
LE89116 use SPI type (Hardware (Normal CS Mode)) ---> 


(0) LE89116 use PIN_CS# 

[ ] LE89116 use 101/102/103 as its LEDO/LED1/Relay (NEW) 
LE89116 PCM owner (share to all DSP) ---> 

[x] LE89316 

[x] LE89316 support wideband 

(1) LE89316 number (NEW) 


This is the 89316 IC numbers on your board 

LE89316 use SPI type (Hardware (Normal CS Mode)) ---> 
(1) LE89316 use PIN_CS# 

LE89316 PCM owner (share to all DSP) ---> 


(3) Control channel number 
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This is the phone port numbers on your board, 89116 has one port, 89316 has 2 ports, so there 
are 3 ports for all. 
4.75 Domain name access of AP 
This feature allows the user to visit the web server of DUT using a domain name (e.g. 


http://wifi.example.com). instead of IP address (e.g -http://192.168.1.254). 


Main menuconfig: 
make linux_menuconfig 
[*] Networking support  ---> 
Networking options = ---> 
[*] | Enable domain name access of AP 


The default domain name of the AP is wifi.example.com, you can change it by writing the following 
proc file: 


echo yourDomainName > /proc/rtl_dnstrap/domain_name 

simultaneously, you should modify the /etc/hosts file while the system initializes. 
For simple, you just need to set this MIB: MIB DOMAIN NAME. 

flash set DOMAIN NAME yourDomainName 

then reinit the system. 

You can enable/disable this function by: 

echo | > /proc/rtl_dnstrap/enable 


echo 0 > /proc/rtl_dnstrap/enable 


4.76 http redirect function 
This feature is for the following function: 


Any http requests from the clients will be redirected to a specific url, only when the user visit the 
url, the client’s MAC address will be added to an allow list, the http requests from the clients whose 


MAC address is already in the list will not be redirected, the client can visit any url normally. 
Main menuconfig: 
make linux_menuconfig 
[*] Networking support ---> 
Networking options ---> 
[*] | Enable Realtek http redirect function 
The following proc files are used to configure this function: 
(1) /proc/http_redirect/enable 
This proc file is to enable/disable http redirect function, 0 for disable, 1 for enable 
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(2) /proc/http_redirect/url 


This proc file is to indicate the url you want the clients to be redirected to. For example, if you 


want the clients’ requests to be redirected to www.myserver.com 
echo “www.myserver.com” > /proc/http_redirect/url 
(3) /proc/http_redirect/client_list 
This proc file can display the current clients who have already visited the url. 
# cat /proc/http_redirect/client_list 
MAC 
00:11:22:33:44:55 
The MAC address of the client who visited the url will be added to this list automatically. 
The user can manually add or delete/flush clients to or from this list,(flush will delete all clients from 
the list) 
e.g.: 
echo delete 001122334455 > /proc/http_redirect/client_list 
echo add 112233445566 > /proc/http_redirect/client_list 
echo flush > /proc/http_redirect/client_list 
NOTICE: 


1. Ifthe redirect url is an Ethernet LAN server within the same subnet of the AP (for example, the 
AP’s IP address is 192.168.1.254, and the redirect host’s IP address is 192.168.1.253), the wired 
clients’ MAC cannot be added to the client list automatically after they are redirected, you should add 


the clients’ MAC address manually, the wireless clients’s MAC can be added automatically. 


2. For some clients(such as some cell phones), when connected to the AP, the client will automatically 
open a browser to redirect to the specified URL, and this only works when the AP can access the 
Internet. If you want this function work when the AP cannot access the Internet, you shoud do as 


follows: 
Edit this file: 
linux-2.6.30/include/net/rtl/rtl_dnstrap.h 
and define the following flag: 
#define SUPPORT_TRAP ALL 
make linux_menuconfig 
[*] Networking support ---> 
Networking options ---> 
[*] | Enable domain name access of AP 


And then rebuild the image. 
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When the AP is connected to the Internet: 
echo 0 > /proc/rtl_dnstrap/trap_all 
else 


echo | > /proc/rtl_dnstrap/trap_all 


4.77 Eth private skb buff support 

CONFIG_RTL_ETH_PRIV_SKB will pre-alloc a memory pool for eth driver. When eth driver 
alloc skb to receive pakcets, the skb bull will be alloc from this pre-alloc memory pool instead of from 
linux kernel memory. And when this skb kfree, this skb buff will be back to this memory pool instead 
of to linux kernel memory. 


How to enable CONFIG_RTL_ETH_PRIV_SKB? 


--- Options for Realtek Soc 
[ ] Auto DHCP Check 


Config MIPSi¢6-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features ---> 
[ ] Enable iptables rule to RTL ACL rule 


bed Support HW Qos 
[*] Enable proc filesystem for debug 
[ ] Enable JUMBO frame support 


4.78 RTL8211F support 


RTL8211F support allows RTL8197F port 0 RGMII interface connecting with RTL8211E an 
external Giga PHY IC. NIC driver would give RTL8211F an PHY ID, 0x6. RTL8211F reset pin is 
GPIO_H2. RTL8197F RGMII Tx delay and Rx delay is 1 and 5, separately. Moreover, if you redesign 
the layout, you should test and find the best Tx delay and Rx delay again. 


4.78.1 How to enable RTL8211F support 
make linux_menuconfig 
---> Device Drivers 
---> Network device support 
---> Options for Realtek SoC 


---> External Switch/PHY support (Enable RTL8211F support) 
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--- Options for Realtek Sof 

[ ] Auto DHCP Check 

Config MIPS16-Inst Option for Kernel Modules ---> 
Config for Layered Driver Features ---> 
[ ] Enable iptables rule to RTL ACL rule 

[*] Enable Ethernet Private Skb 

[ ] Support H¥ Qos 

[*] Enable proc filesystem for debug 

[ ] Enable JUMBO frame support 

[ ] Enable rome perf 

[*] Disable 802.3az EEE feature 

Rtl ethernet 802. 1x support 


External Switch/PHY support (Enable RTL8211F support 


4.78.2 How to verify RTL8211F support 


PC which is connected with RTL8211F port can ping RTL8197F successfully. RTL8197F can 
also ping PC which is on RTL8211F port successfully. 


4.78.3 GPIO Pins Simulate MDC/MDIO support 


For platform which does not equip with dedicated MDC/MDIO pin, we could use two GPIO pins 
to simulate MDC/MDIO signal for communicating with 8211K Our SDK would adopt this support 
automatically if you enable RTL8211F support on RTL8197EN platform. The definition of GPIO pins 
are defined in /linux-3.10/drivers/char/rtl_nfbi/rtl_nfbi.c. The default MDC pin and MDIO pin are 
GPIO_G6 and GPIO_C3 separately. 


#define MDC_PIN BSP_GPIO_PIN_G6 
#define MDIO_PIN BSP_GPIO_PIN_C3 


Customer can change the pin definition depending on your hardware design. For example, if MDC pin 
would be GPIO_H7 and MDIO pin would be GPIO_D4, please see below for the changes: 


#define MDC_PIN BSP_GPIO_PIN_H7 
#define MDIO_PIN BSP_GPIO_PIN_D4 


4.78.4 How to change RTL8211F reset pin 


The reset pin in RTL8197F+RTL8211F demo board is GPIOH2. For example, customer want to 
change to GPIOHO. You should modify /linux-3.10/drivers/net/rtl8 19x/AsicDriver/rtl865x_asicL2.h. 


Original code: 


#define GPIO_RESET BSP_GPIO_PIN_H2 // GPIO_H2 


Modified code: 
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#define GPIO_RESET BSP_GPIO_PIN_H0O 


However, the GPIOHO is used as WPS button in demo board. The gpio_request_one() function in 
init_pOQ function (in rtl865x_asicL2.c) will return failed. Customer may not use WPS button function 
or does not use GPIOHO for WPS button. 


In Realtek SDK, we need to modify /boards/rtl8 197F/bsp/gpio.c to let WPS button use another 
GPIO pin. After do this, the GPIOHO can be used as RTL8211F reset pin. 


Original code: 


#define BSP_WPS_BTN_PIN BSP_GPIO_PIN_H0 
Modified code: 
#define BSP_WPS_BTN_PIN BSP_GPIO_PIN_EO 


4.79 External Switch IC support 
4.79.1 RTL8367RB/ RTL8367RB-VB support with Switch API v1.2.12 


The support list of Switch API v1.2.12 is shown as below, and its source code is located in 
\linux-3.10\drivers\net\rtl8 1 9x\rtl8367r. 


RTL8363SB 
RTL8365MB 
RTL8367-VB 
RTL8367RB 
RTL8367R-VB 
RTL8367MB 
RTL8367M-VB 
RTL8368MB 
RTL8305MB 
RTL8307M-VB 
RTL8367N 
RTL8365MB-VC 
RTL8367RB-VB 
RTL8367N-VB 


For Realtek 8197F+8367RB-VB demo board, the RTL8197F use portO RGMII interface to 
connect with RTL8367RB. RTL8367RB reset pin is GPIO_H2. MDC pin is GPIO_C2 and MDIO pin 
GPIO_C3 because RTL8197F uses two GPIO pin to simulate I2C signal. RTL8197F Tx and Rx delay 
is 0 and 5, separately. RTL8367RB Tx and Rx delay is 0 and 5, separately. Moreover, if you redesign 
the layout, you should test and find the best Tx delay and Rx delay again. 


4.79.1.1 Howto enable RTL8367RB support 


make linux_menuconfig 
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---> Device Drivers 
---> Network device support 


---> Options for Realtek SoC 


---> External Switch/PHY support (Enable RTL8367RB support) 


--- Options for Realtek Sol 

Auto DHCP Check 

Config MIPS16-Inst Option for Kernel Modules 
Config for Layered Driver Features ---> 
Enable iptables rule to RTL ACL rule 
Enable Ethernet Private Skb 

Support HW Qos 

Enable proc filesystem for debug 

Enable JUMBO frame support 

Enable rome perf 

Disable 802.3az EEE feature 

tl ethernet 802.1x support 


—s| 
— 


* 


* 


Coot oes |e Cone (oe | oe eee | oe | 
* 
(| eee | ee eee | ee | eee | ee | 


External Switch/PHY support (Enable RTL8367RB support) 


4.79.1.2 Howto verify RTL8367RB support 


PC which is connected with RTL8367RB port 0~3 can ping RTL8197F successfully. RTL8197F 


can also ping PC which is on RTL8367RB port 0~3 successfully. 


4.79.2 8363NB/8366SC/8365MB/8364NB/8367SB support with Switch API v1.3.9 


The support list of Switch API v1.3.9 is shown as below, and its source code is located in 


\linux-3.10\drivers\net\rtl8 1 9x\rtl83xx. 


RTL8363NB 
RTL8364NB 
RTL8365MB-VC 
RTL8367N-VB 
RTL8367RB-VB 
RTL8367SB 
RTL8367S 
RTL8366SC 
RTL8363SC 
RTL8370MB 
RTL8370N-VB 
RTL8310SR 
RTL8363NB-VB 
RTL8364NB-VB 
RTL8363SC-VB 


We have verified this v1.3.9 API in Realtek 8197F+8367RB-VB demo board and customer 
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8197F+8363NB, 8197F+8366SC, 8197F+8365MB, 8197F+8364NB and 8197F+8367SB board. If 
customer design a board which use the support list IC above, the Switch IC initialization code may be 
modified to match the Switch IC hardware reset pin and MDC/MDIO pin usage. Moreover, you should 
test and find the best Tx delay and Rx delay again. 


How to enable the external Giga Switch support: 
make linux_menuconfig 
---> Device Drivers 
---> Network device support 
---> Options for Realtek SoC 


---> External Switch/PHY support 


External Switch/PHY support 7 
Use the arrow keys to navigate this window or press the hotkey of 
the item you wish to select followed by the <SPACE BAR>. Press 
<?> for additional information about this option. 


Brable RIpobIRe auunont 
‘nable RTL8366SC support 
Enable RTL8363NB support 


Enable RTL8364NB support 


) 
Enable RTL8365MB support 
) Enable RTL8367SB support 


4.79.3, RTL8325D support with Switch API v1.3 
The API source code is located in \linux-3.10\drivers\net\rtl8 1 9x\rtl8325d. 


How to enable RTL8325D support: please enable "Support RTL8325D for RTL8197D" item in 
"System Configuration" menuconfig. 


4.79.4 Some related section and /proc file 


Some related section are section 7.39 “RTL8367RB LED setting”, section 4.58 “IOL Test”, 
section 6.32 “port_status” and section 6.34 “phyReg”. Moreover, there is a useful /proc command to 
dump the Switch IC mib counter: “echo dump 8367 > /proc/rtl865x/asicCounter” or “echo dump 8325 
> /proc/rtl865x/asicCounter”. 
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4.79.5 RTL8197FH + external Giga Switch 


The external Giga switch reset pin and I2C pins are defined in /boards/rtl8 197F/bsp/gpio.c. The 
default external Giga switch reset pin is GPIO_F1. The default I2C pins are GPIO_G6 and GPIO_C3. 
In our SDK, I2C pin] is clock pin and I2C pin2 is data pin. 


#define BSP_8367R_RST_PIN_97FN BSP_GPIO_PIN_F1 
#define BSP_8367R_I2C_PIN1_97FN BSP_GPIO_PIN_G6 
#define BSP_8367R_I2C_PIN2_97FN BSP_GPIO_PIN_C3 


Moreover, Ethernet driver would use reset pin to reset external giga switch and initialize I2C pins. The 
related code is defined in /linux-3.10/drivers/net/rtl8 19x/AsicDriver/rtl865x_asicL2.c : 


init_83XX(): 


#elif defined(CONFIG_RTL_8197F) 
#undef GPIO_RESET 
#define GPIO_RESET 26 // GPIO_H2 
#define GPIO_RESET_97FN 9 // GPIO_F1 


if (bond_id == BSP_BOND_97EN) { 
// MDC: G6, MDIO: C3 
smi_init_83xx(GPIO_PORT_G, GPIO_PORT_C, 6, 3); 


Customer can change the pin definition depending on hardware design. For example, if external Giga 
switch reset pin would be GPIO_HO, please see below for the changes: 


In /boards/rtl8 197F/bsp/gpio.c : 


#define BSP_8367R_RST_PIN_97FN BSP_GPIO_PIN_HO 
#define BSP_8367R_I2C_PIN1_97FN BSP_GPIO_PIN_G6 
#define BSP_8367R_I2C_PIN2_97FN BSP_GPIO_PIN_C3 


In /linux-3.10/drivers/net/rtl8 19x/AsicDriver/rtl865x_asicL?2.c : 


init_83XX(): 
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#elif defined(CONFIG_RTL_8197F) 
#undef GPIO_RESET 
#define GPIO_RESET 26 // GPIO_H2 
#define GPIO_RESET_97FN 24 // GPIO_HO 


The GPIO number please refer to section 7.42 for more information. 


4.80 TSO (TCP Segmentation Offload) / GSO (Generic Segmentation Offload) 
support 


TSO (TCP Segmentation Offload) / GSO (Generic Segmentation Offload) support is applied to 
RTL8197F platform. GSO support is also applied to RTL8198C, RTL8197D, and RTL8881A platform. 
TSO allows data segmentation is offloaded to the NIC in TCP traffic, and divides the data into the 
maximum transmission unit (MTU) size of the outgoing interface. GSO is software implementation of 
TSO. It allows segmentation just before the NIC device driver. TSO is hardware offloading, and GSO 
is software offloading. Both TSO and GSO support can improve the throughput of outbound direction, 


such as samba read. 

4.80.1 How to enable TSO support 

RTL8197F platform: 

make linux_menuconfig 
---> Device Drivers 
---> Network device support 
---> Options for Realtek SoC 
---> Config for Layered Driver Features 
---> [*] Enable hardware TSO support 


*#%#%* Choose basic features. *** 
**%* Choose hardware features. *** 
Hardware Features Selection (Enable RTL Hardware NAPT) ---> 
*##%* Choose advance features. *** 
[ ] Support hw multiast for eth+wlan client 
[ ] Enable extension port support 
[ ] Enable linux ps vs rt1819x driver netif mapping 
[ ] 8t1865x lan port restriction 
[C ] Support multi-vlan in bridge/wisp mode 
[ ] Enable HW DS-LITE SUPPORT 
[ ] Enable HW 6RD SUPPORT 
[.] Enable hardware TSO support(GSO is needed) 


-*- Enable software GSO support 


©2011 Realtek Semiconductor Corp. 259 


There is one thing to note that when you enable hardware TSO support, software GSO support is 
needed. GSO let kernel pass a super-sized packet through TCP protocol stack until entering NIC 
device driver. Kernel would detect that hardware supports TSO and let NIC to segment a super-sized 
packet. If TSO is enabled without GSO, kernel would not pass any super-sized packet to NIC. 


4.80.2 How to enable GSO support 
make linux_menuconfig 
---> Device Drivers 
---> Network device support 
---> Options for Realtek SoC 
---> Config for Layered Driver Features 
---> [*] Enable software GSO support 


*#%* Choose basic features. *** 
*#*%* Choose hardware features. *** 
Hardware Features Selection (Enable RTL Hardware NAPT) ---> 
*#% Choose advance features. *** 
[ ] Support hw multiast for eth+wlan client 
[ ] Enable extension port support 
[ ] Enable linux ps vs rt1819x driver netif mapping 
[ ] 8t1865x lan port restriction 
[C ] Support multi-vlan in bridge/wisp mode 
[ ] Enable HW DS-LITE SUPPORT 
[ ] Enable HW 6RD SUPPORT 
[ ] Enable hardware TSO support(GSO is needed) 
[.] Enable software GSO support 


RTL8198C, RTL8197D, and RTL8881A platform: 
make linux_menuconfig 
---> Device Drivers 
---> Network device support 
---> Options for Realtek SoC 
---> Config for Layered Driver Features 


---> [*] Enable software GSO support 
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*#% Choose basic features. *** 

**% Choose hardware features. *** 
Hardware Features Selection (Enable RTL Hardware NAPT) ---> 
*##%* Choose advance features. *** 
Support hw multiast for eth+wlan client 
Enable extension port support 

Enable multiple wan in hw nat mode 
Support multi-vlan in bridge/wisp mode 
Enable HW DS-LITE SUPPORT 

Enable HW 6RD SUPPORT 

_] Enable software GSO support! 


Seeds idee 
LIbIbLIbIbLILi 


4.81 Webpage in rootfs support 


Webpages may oversize when enable more features or customer add more webpages. 


One solution is to change the flash layout, increase the offset of linux.bin and root.bin, and left 
enough size for webpage.bin. In that case, bootcode may need to update to reach kernel, as linux 
kernel offset have increased. 


Another simple solution is to enable webpage in rootfs support, and all webpages will save in 
rootfs(root.bin). To save the flash space, linux kernel offset can be set to webpage offset. 


* 1ULUWULe OLULLII ViLoOovl, OMUYVULU YO TH ULLsiuieliv ''' 


( x6000) H rdware setting offset in flash. 

ek Default setting offset, should be 4K alignment. *** 

*#e size of default and current setting should be same. *** 
(0x8000) Default setting offset in flash. 

*#e* Current setting offset, should be 4K alignment. *** 
(OxE000) Current setting offset in flash. 


* 


eK ee image offset, should be 4K alignment. *** 


TD Daee OTT ToL t 100K. tt 
) veboage mage oriset in flash, 
eg opines alignment. HR 
l et \ S be tween 0x10000°0x40000, #** 


K alignment, *** 


mee rset image offset in flash. 
*#k wapl partition offset, should be 128K alignment. 


HINA NT Se ee a Sal 


x 
* 
Rte 


4.81.1 How to enable webpage in rootfs support 


make linux_menuconfig 
---> System Configuration 


---> [*] Webpages in rootfs support 
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System Type (97D+92C+92D GW) -——> 
sdram size greater than or equal 32M 
Enable watchdog timer support 
Support rt1821lds for rt18197D 
Support RTL8367R for RTL8197D 

Enable timer adjustment support 
ebpages in rootfs support 

SPI flash support 
8196D PCIE Autoscan PCIE PHY 40Mhz 
Enable Flash Dual Bank support 
USB3G support 


meer || omen | yeereen | saree | | see eee | poe | ene | see | 
— a |) ee ee eee ee ee | 


4.82 PWM support 

4.82.1 related macro 
CONFIG_PWM_RTK 

4.82.2 How to enable PWM 
Location: 

Device Drivers ---> 


[*] Pulse-Width Modulation (PWM) Support = ---> 
<*>  RTK PWM 


4.82.3 How to use PWM 

Realtek 97F has 4 PWM IPs and linux PWM driver(drivers/pwm/pwm-rtk.c), and support 
following linux PWM operations: 
Config: support developer to set duty and period. 

API: .config = rtk_pwm_config 

Function: rtk_pwm_config(struct pwm_chip *chip, struct pwm_device *pwm, 

int duty_ns, int period_ns) 

Linux’s PWM api uses nano second as duty/period resolution, Realtek’s driver will help to 
calculate from nano second to our 16kHz timer and set registers. 
Enable: enable PWM IP and DesignWare’s timer 
Disable: disable PWM IP and DesignWare’s timer 
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And RTK gtimer/PWM resolution is 16kHz, so the duty and period should be 60000ns/60us to 
120ms. 


4.83 SD card support 


4.83.1 related macro 

CONFIG_MMC, CONFIG_MMC_RTK_SDMMC 
4.83.2 Howto enable SD driver 

Location: 
Device Drivers ---> 


<*> MMC/SD/SDIO card support = ---> 


4.83.3 How to use SD driver 
Realtek 97F mmc IP and linux mmc driver(drivers/mmc/host/rtk-sdmmce.c), and support 
following linux SD operations: 
request: support linux mmc to send command to SD card 
get_ro: check read only status 
get_cd: check card detect 
set_ios: change some HW and power settings 
start_signal_voltage_switch: RTK’s IP can support the high speed to HS200, and this function is 
switch voltage to 1.8V 


execute_tuning: RTK sd driver support auto tune phase and timing 


Realtek SD/MMC host driver ---> 
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note: 97F has only one mmc IP for SD card and eMMC, with different driver, developers have to 
check the HW to choose one of them. 


4.83.4 Howto mount SD card on Linux as a file system 
Mount Steps: 
Step1: Make mounted place: “mkdir -p /var/tmp/mmc” 


Step2: Mount device: “mount -o rw /dev/mmcblk0p1 /var/tmp/mmc” (user can use “cat 


/proc/partition” to check the name) 


Check Steps: 
Type “mount” to check some informations like following log: 


/dev/mmcblk0p1 on /var/tmp/mmce type exfat (rw, relatime, fmask=0022, dmask=0022, 
namecase=1, errors=remount-ro) 


Or get into the mount point(/var/tmp/mmc) to check the files on the SD card. 


Note 1: If init fail, please check the /proc/partition to check if the SD card was recognized and init 


successfully 


Note 2: If mount fail, please check linux config to make sure linux has supported the SD card’s File 
System format, as exFAT, NTFS, etc. 


Note 3: Before unplug the SD card, please type unmount command, ex: umount /dev/mmcblk0p1 


4.84 eMMC support 


4.84.1 related macro 

CONFIG_MMC, CONFIG_MMC_RTKEMMC 
4.84.2 How to enable SD driver 

Location: 


Device Drivers. ---> 


<*> MMC/SD/SDIO card support = ---> 
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MM RTK emmc 


4.84.3 How to use eMMC driver 
Realtek 97F mmc IP and linux mmc driver(drivers/mmc/host/ rtkemmc.c), and support 
following linux mmc operations: 
request: support linux mmc to send command to emmc 
get_ro: check read only status 
get_cd: check card detect 
set_ios: change some HW and power settings 


execute_tuning: RTK emmce driver support auto tune phase and timing 


note: 97F has only one mmc IP for SD card and eMMC, with different driver, developers have to 
check the HW to choose one of them. 


4.84.4 How to mount emmc on Linux as a file system 
Unlike SD card, emme cannot formatted by PC, users have to format the emme device on DUT, 


so we have to create partitions and format it to linux filesystem(or other filesystems). 


Related tools: 
1. create partitions tool: fdisk 
Location: busybox config 


Linux System Utilities ---> 
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2. format tool: e2fsprogs 
Location: user config 
File_system Configuration ---> 


[*] e2fsprogs 


3. linux ext4 support: CONFIG_EXT4 FS 
Location: linux config 
File systems ---> 


axup 


a0) 


mc 


< * 


Note: choose backward compatible 


Mount Steps: 
Step1: create partitions: “fdisk /dev/mmcblk0” 
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Command (m for help): d 
Selected partition 1 


Command (m for help): d 
No partition is defined yet! 


Command (m for help): n 
Command action 

e extended 

p primary partition (1-4) 


p 
Partition number (1-4): 1 : 

First cylinder (1-119296, default 1): Using default value 1 

Last cylinder or +size or +sizeM or +sizeK (1-119296, default 119296): Using default value 119296 


Command (m for help): p 


Disk /dev/mmcb1k0: 3909 MB, 3909091328 bytes 
4 heads, 16 sectors/track, 119296 cylinders 
Units = cylinders of 64 * 512 = 32768 bytes 


Device Boot Start End Blocks Id System 
/dev/mmcb1kOp1 aL 119296 3817464 83 Linux 


Command (m for help): w 
The partition ta mmcb1k0O: pl 
ble has been altered! 


"se joctl() to re-read partition table 
# 


Note: use m for fdisk help 


Step2: Format to ext2 filesystem: “mke2fs dev/mmcblkOp1” 


# mke2fs dev/mmcb1kOp1 
mke2fs 1.42.11 (09-Jul-2014) 
dev/mmcb1kOp1 contains a ext2 file system 

created on Fri May 27 09:03:55 2016 
Proceed anyway? (y,n) y 
agp egos rari can't check if filesystem is mounted due to missing mtab file while determining whether dev/mmcb1k 
Op1 is mounted. 
Creating filesystem with 954364 4k blocks and 239040 inodes 
Filesystem UUID: 1feb7223-a278-4d51-b27b-11b51a894b21 
Superblock backups stored on blocks: 

32768, 98304, 163840, 229376, 294912, 819200, 884736 


Allocating group tables: done 
Writing inode tables: done . 
Writing superblocks and filesystem accounting information: done 


#1 

Step3: Make mounted place: “mkdir -p /var/tmp/mmc” 

Step4: Mount device: “mount -o rw /dev/mmcblk0p1 /var/tmp/mmc” 
Check Steps: 


Type “mount” to check some informations like following log: 


/dev/mmeblk0p1 on /var/tmp/mmce type exfat (/dev/mmcblk0p1 on /var/tmp/mmce type ext2 
(rw.relatime)) 


Or get into the mount point(/var/tmp/mmc) to check the files on the emmce. 


Note 1: If init fail, please check the /proc/partition to check if the emmce card was recognized and 


init successfully 
Note 2: If format fail, please check the supported file systems in linux. 


Note 3: If users use some other format tools and get some errors, as mkfs.ext4, mkfs.vfat, etc, please 
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update the busybox or mkfs tools, and comfirm the partition size. 


Note 4: If mount fail, please check linux config to make sure linux has supported the emmc’s File 
System format, as exFAT, NTFS, etc. 


4.85 I2C support 


4.85.1 related macro 


CONFIG_I2C, CONFIG _I2C_DESIGNWARE PLATFORM (8197F), 

CONFIG _I2C_DESIGNWARE_ SLAVE, CONFIG _I2C_DESIGNWARE SLAVE RXDMA, 
CONFIG _I2C_DEFAULT_PINMUX (8197F), CONFIG. I2C_PINMUX 2 (8197F), 

CONFIG _I2C_SLAVE_PINMUX (8197F), CONFIG _RTL8198C_I2C (8198C) 


4.85.2 Pinmux setting 
4.85.2.1 8197F 2C Pinmux 
In I2C platform device file (boards/rtl8 197F/bsp/i2c.c), pinmux related to I2C is set. Some I[2C setting 


should be configured according to practical usage. Default setting is in 
CONFIG I2C_ DEFAULT PINMUxX section. There are three options in the code: 


1. Default setting uses TXCTL an RXCTL in PIN MUX_SEL2 for I2C0. If kernel needs 12C1, 
marked code for I2C1 should be opened. The I2C1 setting uses TXD1 in PIN MUX _SELO and 
RXC in PIN MUX_SEL2. 


2. The other choice CONFIG I2C_PINMUX_ 2 is I2C1 setting uses TXDO in PIN MUX_SELO and 
TXC in PIN MUX_SEL2. I2C0 setting uses TXCTL an RXCTL in PIN MUX_SEL2. 


3. If CONFIG _I2C_ SLAVE PINMUX 1s set, I2CO uses TXC and RXCTL in PIN MUX_SEL2. This 


settting is for I2C slave mode. 


4.85.3 Howto enable I2C driver 


If you want to enable the hardware I2C host controller in the SDK, please enable the following Linux 
configuration. 


4.85.3.1 8197F platform 
1. If you using the 97F platform, and set I2C as master mode. Please refer to the following steps. 


Location: 


Device Drivers ---> 


<*> [2C support ---> 
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I2C Hardware Bus support ---> 
<*> Synopsys DesignWare Platform ---> 


<*> Select DesignWare I2C PINMUX ---> 


Choose pinmux set 


<*> Select DesignWare I2C PINMUX ---> 


Choose pinmux set 


©2011 Realtek Semiconductor Corp. 


2. If you using the 97F platform, and set I2C as slave mode. Please follow the setting of master mode 
above and then refer to the following steps. 
I2C Hardware Bus support ---> 

[*] | Synopsys DesignWare Slave 
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<*> Select DesignWare I2C PINMUX ---> 
Choose pinmux set 
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I 
() [2C0-Slave: TXC + RXCTL 
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3. If you are using DW_GDMA for I2C_slave RX, please follow the I2C slave mode setting above and 
refer to the following steps 
12C Hardware Bus support ---> 

[*] Synopsys DesignWare Slave with DMA rx 
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4.85.3.2 8198C platform 
If you using the 97F platform, please refer to the following steps. 


Location: 
Device Drivers ---> 


<*> [2C support ---> 


12C Hardware Bus support ---> 
<*> Support REALTEK 8198C I2C 
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*** T2C system bus drivers (mostly embedded / system-on-chip) *** 


Location: 
Device Drivers ---> 


[*] DMA Engine support ---> 
<*> Synopsys DesignWare AHB DMA support 


4.85.4 How to use I2C driver 
4.85.4.1 I2C Data Hold Time and I2C Speed Mode in 8197F 
In I2C platform device (boards/rtl8 197F/bsp/i2c.c), I2C data hold time and speed mode can be set. 


If there are many devices on same I2C bus, suggest giving lowest value of maximum data hold time in 
all I2C devices’ spec as data hold time in order to assure enough data hold time for accessing data. For 
instance, DeviceA spec shows maximum data hold time is 500 ns, DeviceB spec shows maximum data 
hold time is 300 ns, and they are on same I2C bus. Data hold time for the I2C bus can be set 300 ns. 


There are three different I2C speed mode: 

1. DW_IC_CON_SPEED_ STD: standard mode is about 40KHz. 

2. DW_IC_CON_SPEED_FAST: fast mode is about 390KHz. 

3. DW_IC_CON_SPEED_HIGH: high speed mode is about 1MHz. 


* Speec mode should match I2C device spec. 
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Because Designware I2C controller uses ic_clk as counting unit, Designware I2C driver will set sda 
hold time after transform its unit into ic_clk. In 8197F setting, the frequency of Designware I2C IP is 
100MHz. Therefore, ic_clk is 1|OOMHz. 
Example: 
If data hold time is 400 nanosecond, Designware I2C driver will set 

(400 * ic_clk + 500000000) / 1000000000 = 40 ic_clk. 


4.85.4.2 Time Setting for IZC Controller timeout in 8197F 
Time of I2C controoler timeout can be adjusted in I2C platform device (boards/rtl8197F/bsp/i2c.c). 


The time unit is millisecond. In I2C driver, the time is transformed to the time whose unit is in jiffies. 
The formula is as following: 


Timeout time in jiffies = (Timeout time in millisecond) * HZ/ 1000 


If you want to change the time of controller timeout, .timeout_time_ms in bsp_dw_i2c_info_device0 
or bsp_dw_i2c_info_devicel (at boards\rtl8197F\bsp\i2c.c) can be modified. 
static struct dw_i2c_dev_info bsp_dw_i2c_info_deviceO = { 
.sda_hold_time_ns = 400, 
.speed_mode = DW_IC_CON_SPEED_STD, 
.timeout_time_ms = 5000, 
.12c_bus_recovery = { 
.prepare_recovery = (void *)i2cO_prepare_recovery, 
.unprepare_recovery = (void *)i2cO_unprepare_recovery, 
.Sda_gpio = BSP_GPIO_PIN_Cl, 
.scl_gpio = BSP_GPIO_PIN_C0, 
}, 
}s 


After I2C controller timeout, if I2C situation is still abnormal, I2C driver will try to use I2C gpio mode 


to recover I2C bus status. 


4.85.4.3 User Space 
Designware driver doesn’t support IOCTL, but users might use SMBUS IOCTL or other similar 


method to connect Designware driver. 


4.86 DesignWare SPI support 
DesignWare SPI, now, is supported on RTL8197F platform. The following figure guides how to 


enable DesignWare SPlIcontroller and driver. According to your hardware design, you can specify 
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which controller has to be enabled. 
make linux_menuconfig 
-> Machine selection 
-> System Configuration 
[*] BSP DesignWare SPI controller support 
[*] | Enable DesignWare SPIO controller 


[*] | Enable DesignWare SPI1 controller 


System Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 
(-) 
[*] 8SP GPIO controller support 


SSP DestgnWare SPI controller suppor 
[*] Enable DesignWare SPIO controller 
[*] Enable DesignWare SPI1 controller 
| EnaDle Flash Mapp tnc 
*** Flash size 4M or 8M, default 4M *** 


4.87 LCD Module support 


4.87.1 fbtft-master 
fbtft-master is a TFT-LCD display driver which is supporting several TFT-LCD modules and used 
to control these modules through SPI bus. The following figure is a example to enable this driver when 
using ILI9341 TFT-LCD module. 
NOTE: If your TFT-LCD module is connected with DesignWare SPI controller, please refer section 
4.86 to enable DesignWare SPI controller. 
make linux_menuconfig 
Device Drivers 
-> Graphics support 
<*> Support for frame buffer devices 
<*> Support for small TFT LCD display modules ---> 
<*> FB driver for the ILI9341 LCD Controller 
<*> Module to for adding FBTFT devices 
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Graphics support 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


< > Direct Rendering Manager (XFree86 4.1.0 and higher DRI suppor 
< > Lowlevel video output switch controls 
upport for frame buffer devices ---> 


Exynos Video driver support ---> 

-*- Backlight & LCD device support ---> 

[ ] Bootup logo ---> 

<*> Support for small TFT LCD display modules ---> 


Support for small TFT LCD display modules 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 
FB driver for the HX8347D LCD Controller 
FB driver for the HX8353D LCD Controller 
FB driver for the ILI9320 LCD Controller 
FB driver for the ILI9325 LCD Controller 
FB driver for the ILI9340 LCD Controller 


*- B driver for the ILI9341 LCD Controller 


> FB driver for the ILI9481 LCD Controller 


VOM 


AEMAAAAA 


Support for small TFT LCD display modules 

Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 

(-) 
FB driver for the SSD1331 LCD Controller 
FB driver for the SSD1351 LCD Controller 
FB driver for the ST7735R LCD Controller 
FB driver for tinylcd.com display 
FB driver for the TLS8204 LCD Controller 
FB driver for the UC1701 LCD Controller 
FB driver for the uPD161704 LCD Controller 
FB driver for the WATTEROTT LCD Controller 


Generic FB driver for TFT LCD displays 
*S Module to for adding FBTFT devices 


VO Vv VOM MOF 


Vv 


< 
< 
< 
< 
< 
< 
< 
< 
: 
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4.88 802.11v BSS transition support 


802.11v BSS transition management introduces a concept for AP to weight nearby basic service sets to 


the client. So, client can use this information to make the better roaming decision. At present, 802.11v 
is defined under 802.11k. 

To enable this feature, select “Config kernel”-> “Device Drivers”->“Network device 
support”->“Wireless LAN” 


Compile SDK to generate new image. 


After the new image is uploaded, the bss transition support related options are in the advanced menu. 


BASIC SETTING knowledge about wireless LAN. These settings should not be changed unless you know what * 
effect the changes will have on your Access Point. 
Fragment Threshold: = 2246 (256-2346) 
TY 
rrsthrestee (52049 
seiner = ig 
TAPP: ® Enabled © Di 
a a= 
tne 


Short GI: @ Enabled Disabled 
I isirerton ened & oad 
mc Ss Co 
LDPC: @ Enabled © Disabled 
= 
TX Beamforming: @ Enabled Disabled 
MU MIMO: C Enabled © Disabled 
Mutilcast to Unicast! §= @ Enabled © Disabled 
TDLS Prohibited: C Enabled © Disabled 
TDLS Channel Switch C Enabled @ Disabled 
RF Output Power: © 100% © 70% © 50% © 35% © 15% 
802.11k Support: @ Enabled Disabled 
802.11v BSS Transition 
@ © Di 
Giseark: Enabled © Disabled 


Save & Apphy Reset 


(sill 
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4.89 Monitor Mode Support 


Monitor mode is used as packet analyzer to collect the wifi information. At present feature, 

management and data frames will be collected. Besides, in Monitor mode, the wlan driver will 
start a timer function to scan each channel for 500ms. We also support user to modify the 
listen period or listen in fixed channel. 


To enable this feature, select “Config kernel” -> “Device Drivers”->“Network device 


support”->“Wireless LAN” 
Enable Monitor mode support 


nitor mode support 
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mM 
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To enable this feature, select “Config Users” 


ibraries Settings ---> 


[@] Libpeap library 
p 


4.90 Bluetooth Repeater Config Support 


Bluetooth Repeater Config allows the user to configure the DUT as a repeater using a 
cellphone via Bluetooth. 
4.90.1 How to Enable Bluetooth Repeater Config 
(1) Bluetooth should be enabled first, please refert to 4.55: Realtek Bluetooth support 
(2) kernel config 
Realtek Bluetooth repeater config: 
Device Drivers ---> 
[*] Network device support ---> 
[*] Wireless LAN ~ ---> 
[*] | Realtek Blueooth repeater config 


Auto DHCP Check: 

Device Drivers ---> 

[*] Network device support ---> 

[*] Options for Realtek SoC — ---> 
[*] | Auto DHCP Check 
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(3) users config 
[*] | Realtek Bluetooth Repeater Config 


JFFS2 Support: 
File systems ---> 
[*] Miscellaneous filesystems  ---> 


<*> Journalling Flash File System v2 (JFFS2) support 
(0) JFFS2 debugging verbosity (0 = quiet, 2 = noisy) 
[*] JFFS2 write-buffering support 


4.90.2 How to test Bluetooth Repeater Config 
Please refer to Android_BTConfigAPP_User_Guide_v1.0.pdf and 
iOS_BTConfigAPP_User_Guide_v1.0.pdf 


4.91 Miniigd IPv6 support 


4.92 Smart Roaming support 

Smart Roaming is Realtek proprietary feature. It detects whether a wireless client is connecting to the 
best AP regarding to performance, and if it is not, help the client to roam to the AP which can provide 
the best performance for the client in the network. 

To enable this feature, please select related options in menuconfig, as following demonstrated. 


Select “Config kernel” and “Config users” 
PADADISITIII III IST IIIA III I I I II ITI I II SI SI IST II III III SII ITI III IIS ISIS II ITIIITII 
RLX Linux Configuration 


Cc 
L 


, and then exit. 
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Select option of “Device Drivers”->“Network device support”->“Wireless LAN”, you would see 
below figures. Make sure “RTK Smart Roaming Support” is selected from kernel 


Se ee ee ee ee ee ee a a ee 


Wireless LAN 


, and “smart roaming support” is selected from users. 


REX Linux Configuration 


d 


FE 
= 


] smart roaming support 


R 


(— 
¢ 
g 


io 


Then, compile SDK to generate new image. 


After the new image is uploaded, “Smart Roaming Suport” option would appear in both WLAN1 
and WLAN? advanced setting page. 
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nie ee a uae. 
ADVANCED These settings are only for more technically advanced users who have a sufficient kne 
should not be changed unless you know what effect the changes will have on your Act 
Fragment Threshold: 2346 256-2346) 
RTS Threshold: 2347 (0-2347) 
wos serring | Beacon Interval: 100 (20-1024 ms) 
WDS SETTING 
IAPP: ‘Enabled \ Disabled 
Protection: \ Enabled © Disabled 
Aggregation: ‘Enabled \~ Disabled 
Short GI: Enabled \ Disabled 
| owes WLAN Partition: © Enabled © Disabled 
STBC: ‘© Enabled \ Disabled 
LDPC: ® Enabled \ Disabled 
TX Beamforming: ® Enabled \ Disabled 
MU MIMO: \ Enabled ™ Disabled 
Mutilcast to Unicast: ® Enabled \ Disabled 
RF Output Power: ©100% U70% U50% UY35% 015% 
802.11k Support: ® Enabled \ Disabled 
ae Enabled © Disabled 
one a aed edie 


4.93 Auto DHCP 


Auto dhcp function can decide lan interface (br0) run dhcpe or dhcpd daemon according front 
end router. If DUT can get IP from front end router, it runs dhcpc daemon on br0, otherwise it runs 
dhcpd daemon on br0. 

4.93.1 How to Enable Auto DHCP 

(1) kernel config 

Device Drivers ---> 

[*] Network device support ---> 

[*] | Options for Realtek SoC ---> 

[*] | Auto DHCP Check 

(2) Configure DUT to Bridge mode and LAN DHCP server on webpage or flash command. 
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5 FLASH tools 


FLASH tools such as flash, cvcfg-gw, compweb, cvimg, mgbin are stored at 
rtl8 19x/users/goahead-2.1.1/LINUX or rtl819x/users/boa/tools if Boa web server is selected. 


5.1 flash 

Read/write MIB in Flash. 

Usage: 

Command Description 

flash all Dump all MIB name and value in Flash 


flash get [wlan-idx] <MIB name> 


Get MIB value from Flash 


flash set [wlan-idx] <MIB name> <MIB value> 


Set MIB value into Flash 


flash set [wlan-idx] <MIB name> 
<action > <MIB table entry> 


Set MIB table entry into Flash 


flash reset 


Reset current settings (use default settings) 


flash default-sw 


Reset Current and Default settings 


flash default 


Reset HW, Current, and Default settings 


flash set_mib 


Get MIB from flash and set to WLAN interface 


flash setconf start 


Create a temporary file /var/sys.conf to save 
MIB value. 


flash setconf [wlan-idx]< MIB name> <MIB value> 


Write MIB value into /var/sys.conf 


flash setconf end 


Set all the MIBs value in /var/sys.conf into 
Flash at one time and remove /var/sys.conf after 


set successfully. 


Examples: 
flash all | grep HW 
flash get WLANO_SSID 
flash set WLANO_SSID test 
flash set WDS add 00e04c8196cc comment 0 


flash setconf start 
flash setconf WLANO_SSID test 
flash setconf IP_ADDR 192.168.1.1 
flash setconf HW_WLANO_LED_TYPE 3 
flash setconf end 
flash 


// find all MIB in HW settings 

// get SSID in wlanO 

// set SSID to test in wlan0 

// add 00e04c8196cc to WDS, 0 is autorate 


// create file /var/sys.conf to save MIB value 
// save wlanO SSID value to /var/sys.conf 

// save LAN IP address value to /var/sys.conf 
// save wlan0 LED type value to /var/sys.conf 


// set all the MIB value in /var/sys.conf into 


Note: ”flash setconf” command can be used when SET MIB FROM FILE is defined in 
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“users/COMMON_ FLAGS.mk”. 


5.2 cvcfg-gw 
MIB binary and text conversion tool. 
Usage: 
cvcfg-gw [-r] [-no_hw] <input> <output> 
Options: 
-r: generate raw configuration with padding 0 
-no_hw: do not to generate hw setting 
-in: input file path //convert binary file to txt must use this option 
-ot: output file path //convert binary file to txt must use this option 
Examples: 
cvcfg-gw config-gw-96c.txt config-gw-96c.dat //convert txt to binary file 
cvcfg-gw —r —no_hw config-gw-96c.txt config.bin //convert txt to binary file generate no hw 


cvcfg-gw —in config-gw-96c.dat —ot config-gw-96c.txt //convert binary file to txt 


5.3. compweb 
Convert WEB pages to be the downloadable binary. 
Usage: 
compweb <mode> <fileList> <output name> 
Options: 
- mode: gw 
Examples: 
find ../web-gw -name "*.*" > web_files 


compweb gw web_files webpages-gw.bin 


5.4 cvimg 
Convert image to be the downloadable binary. 
Usage: 
cvimg <image type> <image> <output file> <load address> <flash offset> 
Options: 
- Image type: root / boot / linux 
- Load address: used in linux type 
- Flash offset: burn address on flash 
Examples: 
cvimg root squashfs-lzma.o root.bin 0x100000 0x100000 
cvimg boot boot boot.bin 0 0 
cvimg linux nfjrom linux.bin 80500000 30000 
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5.5 mgbin 
Merge all binary into one image. 
Usage: 
mgbin [-s] [-c] [-a] -o outputfile bootcode config webpages linux root 
Options: 
-s: do byte swap 
-c: cascade. May use this option to merge image for web upload 
-a: add all tag in header 
Examples: 
1) Create full image (rtl8196c-gw.bin) for TFTP update. 
cvcfg-gw —r config-gw-96c.txt config-gw-96c.bin 
mgbin —o rtl8196c-gw.bin boot.bin config-gw-96c.bin webpages-gw.bin linux.bin root.bin 


Note: add -s if need swap 


2) Create total image (rtl8196c-gw.bin) without boot loader and HW settings for TFTP update. 


cvcfg-gw —r —no_hw config-gw-96c.txt config-gw-96c.bin 
mgbin —o rtl8196c-gw.bin config-gw-96c.bin webpages-gw.bin linux.bin root.bin 
3) Create total image (rtl8 196c-gw.bin) for WEB upgrade. 
mgbin —o rtl8 196c-gw.bin webpages-gw.bin linux.bin root.bin 
4) Create total image (rtl8 196c-gw.bin) with config dates for WEB upgrade. 
cvcfg-gw config-gw-96c.txt config-gw-96c.dat 


mgbin —c —o rtl8196c-gw.bin config-gw-96c.dat webpages-gw.bin linux.bin root.bin 
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6 Proc file format 


6.1 br_igmpProxy 
Path: /proc/br_igmpProxy 
Description: Enable/Disable IGMP proxy function. 
Input Format: 
Echo “$FLAG” > /proc/br_igmpProxy 
Input Para: 
* 1: Enable IGMP proxy. 
* 0: Disable IGMP proxy. 
Output Format: 
$FLAG 
Output Para.: 
* 1: IGMP proxy daemon is running. 


* 0: IGMP proxy daemon is not running. 


6.2 br_igmpsnoop 
Path: /proc/br_igmpsnoop 
1) Description: Enable/Disable IGMP snooping. 
Input Format: 
Echo “$FLAG” > /proc/ br_igmpsnoop 
Input Para: 
* 1: Enable IGMP snooping. 
* Q: Disable IGMP snooping. 
Output Format: 
$FLAG 
Output Para: 
* 1: IGMP snooping enabled. 
* 0: IGMP snooping disabled. 


2) Description: Configure reserved multicast address not processed by multicast fastfwd. 
Input Format: 
Echo “reserve $McastAddr” > /proc/ br_igmpsnoop 
Input Para: 
*McastAddr: The reserved multicasts address 
Output Format: 
None 


Output Para: 
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None 


3) Description: Enable/Disable fast leave 
Input Format: 
Echo fastleave “$FLAG1” “$FLAG2” > /proc/ br_igmpsnoop 
Input Para: 
FLAGI: 1: Enable IGMP fast leave; 0: Disable IGMP snooping. 
FLAG2: last member aging time when disable fast leave 
Output Format: 
None 
Output Para: 
None 


4) Description: configure src mac address of multicast packet forward by HW 
Input Format: 
echo mcastMac “$Enabled” “$oriMac” “$replaceMac” > proc/br_igmpsnoop 
Input Para: 
Enabled: 1:enabled configure src mac process;0: disable configure src mac process. 
oriMac: original src mac address before configure 
replaceMac: the configured src mac address for hw multicast 
Output Format: 
meastMac: [$Enabled] oriMac: $oriMac replaceMac: $replaceMac 
Output Para: 
Enabled: 1:enabled configure src mac process;0: disable configure src mac process. 
oriMac: original src mac address before configure 


replaceMac: the configured src mac address for hw multicast 


6.3. custom_Passthru 
1) Path: /proc/ custom_Passthru 
Description: Enable/Disable IPv6/PPPoE pass through for gateway mode. 
Input Format: 
Echo “$FLAG” > /proc/ custom_Passthru 
Input Para.: 
* bit O for IPv6 pass through control and bit | for PPPoE pass through control. 
* 0: Disable both IPv6 and PPPoE pass through. 
* 1: Enable IPv6 pass through and disable PPPoE pass through. 
* 2: Enable PPPoE pass through and disable IPv6 pass through. 
* 3: Enable both IPv6 and PPPoE pass through. 
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Output Format: 
$FLAG 
Output Para: 


* 0: Both IPv6 and PPPoE pass through disabled. 

* |: IPv6 pass through enabled and PPPoE pass through disabled. 

* 2: PPPoE pass through enabled and PPPoE pass through disabled. 
* 3: Both IPv6 and PPPoE pass through enabled. 


2) Path: /proc/custom_Passthru_wlan 


Description: Enable/Disable IPv6/PPPoE pass through for WISP mode. 


Please refer to the 7.14 and 7.30 for the entire configure sequence of pass through. 


6.4 enable_dos 


Path: /proc/enable_dos 


Description: 


Input Format: 


Echo “$FLAG” > /proc/enable_dos 


Input Para.: 


* Ist parameter: operation mode. 


* 2nd parameter: brO IP address. 


* 3rd parameter: 
* Ath parameter: 
* Sth parameter: 
* 6th parameter: 
* 7th parameter: 
* 8th parameter: 


* Oth parameter: 


brO subnet mask. 
item number. 

whole SYN threshold. 
whole FIN threshold. 
whole UDP threshold. 


whole ICMP threshold. 


per SYN threshold. 


* 10th parameter: per FIN threshold. 
* 11th parameter: per UDP threshold. 
* 12th parameter: per ICMP threshold. 


* 13th parameter: block time. 


Output Format: 
$FLAG 
Output Para.: 


* NULL: disable dos. 


* Ist parameter: operation mode. 


* 2nd parameter: brO IP address. 


* 3rd parameter: 


* Ath parameter: 


brO subnet mask. 


item number. 
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* Sth parameter: whole SYN threshold. 
* 6th parameter: whole FIN threshold. 

* 7th parameter: whole UDP threshold. 
* 8th parameter: whole ICMP threshold. 
* Oth parameter: per SYN threshold. 

* 10th parameter: per FIN threshold. 

* 11th parameter: per UDP threshold. 

* 12th parameter: per ICMP threshold. 


* 13th parameter: block time. 


6.5 fast_l2tp 
Path: /proc/fast_l2tp 


Description: 
Input Format: 
echo “$FLAG” > /proc/fast_l2tp 
Input Para: 
* 1: the file value is 1 when the WAN interface type is set to L2TP 
* 0: the file value is 0 when the WAN interface type is not set to L2TP 
Output Format: 
$FLAG 
Output Para: 
* 1: the file value is 1 when the WAN interface type is set to L2TP 
* 0: the file value is 0 when the WAN interface type is not set to L2TP 


6.6 fast_pppoe 
Path: /proc/fast_pppoe 
Description: 
Input Format: 
echo “$FLAG” > /proc/fast_pppoe 
Input Para: 
* 1: enable fast pppoe 
* 0: disable fast pppoe 
For example: 
Disable fast pppoe, run the following command: 
echo 0 >/proc/fast_pppoe 
Enable fast pppoe, run the following command: 


echo | >/proc/fast_pppoe 
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6.7 fast_nat 
Path: /proc/fast_nat 


Description: 

Cases 1), if CONFIG_RTL_NF_CONNTRACK GARBAGE _ NEW is not enabled at kernel 
configure, /proc/fast_nat is only used for fastpath control. 

Cases 2), if CONFIG_RTL_NF_CONNTRACK_ GARBAGE NEW is enabled at kernel 
configure, /proc/fast_nat is used for fastpath control and fastpath garbage collection rx threshold 
control. 

Input Format: 

echo “$FLAG” > /proc/fast_nat 
Input Para.: 

* 0: fastpath disabled 

* 2: flush conntrack at kernel 

* non-zero and not equal to 2: fastpath enabled 

* larger than 2: assign it to the fastpath garbage collection rx threshold. Note: this is only for 
case 2) above. 

Output Format: 

$FLAG 
Output Para.: 

For case 1), output “fastpath: [%d]” 

* 10: disable fastpath. 
* 11: enable fastpath. 
* 12: clean the conntrack table. 
For case 2), output “fastpath %s, GC_RX_ Count %d, Status: %od” 
* fastpath enabled or disabled 
* GC_RX_Count is the fastpath garbage collection rx threshold 


* Status is the status for new garbage collection 


6.8 fast_pptp 
Path: /proc/fast_pptp 
Description: 
Input Format: 
echo “$FLAG” > /proc/fast_nat 
Input Para.: 
* 1: the file value is 1 when the WAN interface type is set to PPTP 
* 0: the file value is 0 when the WAN interface type is not set to PPTP 
Output Format: 
$FLAG 
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Output Para: 
* 1: the file value is 1 when the WAN interface type is set to PPTP 
* Q: the file value is 0 when the WAN interface type is not set to PPTP 


6.9 filter_table 
Path: /proc/filter_table 
Description: url filter control 
Input Format: 
echo “$STR” > /proc/filter_table 
Input Para: 
*1: “flush 
Clear filter table, no parameter. 
*2: “init $list_id 
Initial the list with the id ($list_id) 
$ list_id: several filter lists are created in filter table, list_id is the id of list 
#define IP_RANGE_TABLE 1 
#define MAC_TABLE 2 
#define URL_KEY_TABLE 3 
#define SCHEDULT_TABLE 4 
#define CONTENT_FILTER re 
*3: “add:$resv#$list_id $flag $num keyl key2 ...” 
Add url rule 
$resv: reserved, set 0 recommended. 
$list_id: several filter lists are created in filter table, list_id is the id of list 
$flag: flag of filter rules 
bitO: is the first condition? 1;0 //If this list is the first condition, bitO is set 1, 
because only url list exist 
bitl: have next condition? 1:0 [next table condition] //If there is continuous 
condition, bit1 is set 1 
bit2: have "and" logic condition? 1:0 
bit3: default action: 1 block;0 forward //action of match: drop or forward 
bit4~7: the index of "and" logic rule 
bit8: all match flag 1: all, 0: not all 
bit9: NULL flag, 1:NULL, 0: not NULL 
$num: number of keyword 
*4: “enable_log” 
Enable log of filter related. It will be shown at log webpage of AP. 
*5: “white” 


Set URL filter mode to white list. 
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*6: “black” 
Set URL filter mode to black list. 


Output Format: 


type=$list_id num=$item_num+1 


index=$list_index url=$key1 
index=$list_index url=$item_num 
Output Para.: 
6.10 gpio 


Path: /proc/gpio 

Description: The /proc/gpio was used for led control and push button.It’s depends on the 
hardware. 

Input Format: 

Input Para. 

Output Format: 

Output Para.: 


6.11 pptp_conn_ck 
Path: /proc/ pptp_conn_ck 
Description: for pptp dial-on-demand wan type, if wan is not dialed up, wan ip(10.64.64.*) is 
invalid, the packets from lan to wan will not go thru fast pptp, but go up to linux kernel to trigger pptp 
dialing up. 
Input Format: 
echo $FLAG > /proc/pptp_conn_ck 
Input Para: 
* 3: wan type is pptp dial-on-demand and wan ip is 10.64.64.*, the packets from lan to wan 
will go up to linux kernel to trigger pptp dialing up 
* others: disable this function 
Output Format: 
$FLAG 
Output Para: 
* 3: wan type is pptp dial-on-demand and wan ip is 10.64.64.*, the packets from lan to wan 
will go up to linux kernel to trigger pptp dialing up 


* others: disable this function 


6.12 qos 
Path: /proc/ qos 
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Description: Enable/Disable fastpath qos control. 
Input Format: 
Echo “$FLAG” > /proc/ qos 
Input Para: 
* 0: QoS disabled 
* non-zero value: QoS enabled 
Output Format: 
$FLAG 
Output Para: 
* Q: QoS disabled 


* non-zero value: QoS enabled 


6.13 rf_switch 
Path: /proc/ rf_switch 


Description: check the current state of wireless. 
Input Format: 
none 
Input Para.: 
none 
Output Format: 
$FLAG 
Output Para: 
* Q: the current state of wireless is enabled. 


* 1: the current state of wireless is disabled. 


6.14 rtk_vlan_support 
Path: /proc/ rtk_vlan_support 
Description: enable/disable rtk vlan feature 
Input Format: 
echo $FLAG >/proc/rtk_vlan_support 
Input Para: 
0: disable rtk vlan feature 
1: enable rtk vlan feature 
Output Format: 
$FLAG 
Output Para: 
(0: the current state of rtk vlan feature is disabled 


1: the current state of rtk vlan feature is enabled 
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6.15 mib_vlan 
Path: /proc/ethx/mib_vlan 
Description: set the vlan feature of each interface. Each port is mapped to one interface ethx; 
from left to right is ethO, eth2, eth3, eth4, eth1. 
Input Format: 
echo "1 $is_lan $vlan $tag $vid $priority $cfi" > /proc/ethO/ mib_vlan 
Input Para: 
is_lan = 1; //1:lan, 0: wan 
vlan = 1; //1:enable rtk vlan in this port, 0: disable rtk vlan feature in this port 
tag = 0; // 1: only received vlan tagged packet and transmit packet with vlan tagged, 0: 
received both vlan tagged and vlan untagged packet and transmit packet with UNTAGGED 
vid = vlan id; //vlan id: 1~4095. 
priority = x; //priority value in 802.1Q (O~7) if transmit packet with vlan tagged. 
cfi=0; //cfi value in 802.1Q tag if transmit packet with vlan tagged. 
Output Format: 
$Global_vlan $is_lan $vlan $tag $vid $priority $cfi 
Output Para.: 
Global_vlan; // 1: rtk vlan feature is enable in whole system; 0: rtk vlan feature is disable in 
whole system 
is_lan; //1:lan, 0: wan 
vlan; //1:enable rtk vlan in this port, 0: disable rtk vlan feature in this port 
tag; // 1: only received vlan tagged packet and transmit packet with vlan tagged, 0: received 
both vlan tagged and vlan untagged packet and transmit packet with UNTAGGED 
vid; //vlan id: 1~4095. 
priority; //priority value in 802.1Q (0~7) if transmit packet with vlan tagged. 
cfi; //cfi value in 802.1Q tag if transmit packet with vlan tagged. 


6.16 sw_nat 


Note: proc sw_nat exist when CONFIG_RTL_HARDWARE_NAT is not defined. 
Path: /proc/ sw_nat 
Description: when hardware NAT is disabled, change the op mode of AP. 
Input Format: 

echo “$FLAG” /proc/sw_nat 
Input Para: 

* “echo 0 > /proc/ sw _nat” : change the op mode of AP to Gateway mode. 

* “echo | >/proc/ sw __nat” : change the op mode of AP to Bridge mode. 

* “echo 2 > /proc/ sw _nat” : change the op mode of AP to WISP mode. 
Output Format: 
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$FLAG 
Output Para: 
* 0: the op mode of AP is Gateway mode. 
* 1: the op mode of AP is Bridge mode. 
* 2: the op mode of AP is WISP mode. 


6.17 hw_nat 
Note: proc hw_nat exist when CONFIG_RTL_HARDWARE_NAT is defined. 


Path: /proc/hw_nat 
Description: Flags for hardware NAT control 


Input Format: 
echo “$FLAG” > /proc/hw_nat 
Input Para: 
* the unit is non-zero: hardware NAT enabled 
* the unit is 0: hardware NAT disabled 
* “echo 0 > /proc/hw_nat” : hardware NAT disabled, change to gateway mode. 
* “echo 1 > /proc/hw_nat” : hardware NAT enabled, change to gateway mode. 
* “echo 2 > /proc/hw_nat” : Change to bridge mode. 
* “echo 3 > /proc/hw_nat” : Change to WISP mode. 
* “echo 4 > /proc/hw_nat” : simply disabled the hardware NAT. 
* “echo 5 > /proc/hw_nat” : simply disabled the hardware NAT. 
* “echo 8 > /proc/hw_nat” : simply disabled the hardware NAT. 
* “echo 9 > /proc/hw_ nat” : init hardware NAT parameters. (Must init before hardware 
NAT works) 
Output Format: 
$FLAG 
Output Para: 
* 0: gateway mode & hardware NAT disabled. 
* 1: gateway mode & hardware NAT enabled. 
* 2: bridge mode. 
* 3: WISP mode. 
* 4: hardware NAT disabled. 
* 5: hardware NAT disabled. 
* 8: hardware NAT disabled. 
* Q: hardware NAT parameters have already initialized. 


* others: no means 
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6.18 br_wlanblock 
Path: /proc/br_wlanblock 

Description: Enable/Disable wlan block. 
Input Format: 

Echo “$FLAG” > /proc/ br_wlanblock 
Input Para: 

* 1: Enable wlan block relay. 

* Q: Disable wlan block relay. 
Output Format: 

$FLAG 
Output Para: 

* 1: wlan block relay enabled. 

* 0: wlan block relay disabled. 


6.19 Mirror port 
Path: /proc/rtl865 x/mirrorPort 
Description: control for mirror port 
Input Format: 
echo "mirror $rxport_mask $txport_mask $mirror_port_mask" > 
/proc/rtl865x/mirrorPort 
Input Para: 
rxport_mask:the port mask which the rx port been mirrored 
txport_mask: the port mask which the tx port been mirrored,if set the rxport_mask and 
txport_mask at the same time,the rxport_mask must be equal to the txport_mask 
mirror_port_mask: the port mask which the port been mirrored to 
Output Format: 
Mirror Rx: 0x0 
Mirror Tx: OxO 
Mirror Port: 0x0 
Output Para: 
Mirror Rx: the port mask which the rx port been mirrored 
Mirror Tx: the port mask which the tx port been mirrored 


Mirror Port: the port mask which the port been mirrored to 


6.20 br_igmp Version 
Path: /proc/br_igmp Version 
Description: The IGMP version support. 
Input Format: 
Echo “$FLAG” > /proc/ br_igmp Version 
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Input Para: 
* 2: IGMP version 2. 
* 3: IGMP version 3. 
Output Format: 
$FLAG 
Output Para: 
* 2: IGMP version 2. 
* 3: IGMP version 3. 


6.21 br_igmpquery 
Path: /proc/br_igmpquery 
Description: Enable/Disable IGMP query. 
Input Format: 
Echo “$FLAG” > /proc/ br_igmpquery 
Input Para: 
* 1: Enable IGMP query. 
* 0: Disable IGMP query. 
Output Format: 
$FLAG 
Output Para: 
* 1: IGMP query enabled. 
* 0: IGMP query disabled. 


6.22 br_mCastFastFwd 


Path: /proc/ br_mCastFastFwd 
Description: Enable/Disable ipMulticastFastFwd. 
Input Format: 

Echo “$FLAG1 $FLAG2” > /proc/ br_mCastFastFwd 
Input Para.: 
1)$FLAGI: 

*1: ipMulticastFastFwd enabled 

*0: ipMulticastFastFwd disabled 
2)$FLAG2: 

*1: needCheckMfc enabled 

*O: needCheckMfe disabled 
Output Format: 

$FLAG1,$FLAG2 
Output Para: 
1)$FLAGI: 


©2011 Realtek Semiconductor Corp. 


296 


*1: ipMulticastFastFwd enabled (ip multicast fast forward) 


*0: ipMulticastFastFwd disabled 
2) $FLAG2: 


*1: needCheckMfc enabled (need check multicast forwarding cache) 


*O: needCheckMfc disabled 


6.23 br_mldquery 
Path: /proc/ br_mldquery 


Description: Enable/Disable mld query. 


Input Format: 
Echo “$FLAG” > /proc/ br_mldquery 
Input Para.: 
* 1: Enable mld query. 
* Q: Disable mld query. 
Output Format: 
$FLAG 
Output Para.: 
* 1: mld query enabled. 
* 0: mld query disabled. 


6.24 br_mldsnoop 
Path: /proc/ br_mldsnoop 


Description: Enable/Disable mld snooping. 


Input Format: 
Echo “$FLAG” > /proc/ br_mldsnoop 
Input Para: 
* 1: Enable mld snoop. 
* Q: Disable mld snoop. 
Output Format: 
$FLAG 
Output Para: 
* 1: mld snooping enabled. 


* 0: mld snooping disabled. 


6.25 eee 
Path: /proc/eee 

Description: Enable/Disable eee. 
Input Format: 

Echo “$FLAG” > /proc/ eee 


©2011 Realtek Semiconductor Corp. 


297 


Input Para: 
* 1: Enable eee. 
* 0: Disable eee. 
Output Format: 
$FLAG 
Output Para: 
* 1: eee enabled. 
* 0: eee disabled. 


6.26 gc_overflow_timeout 
Path: /proc/gc_overflow_timeout 
Description: gc_overflow_timeout. 
Input Format: 
Echo “$FLAG” > /proc/ gc_overflow_timeout 
Input Para: 
$FLAG: rtl_gc_overflow_timout 
Output Format: 
$FLAG1 $FLAG2 
Output Para: 
$FLAGI: rtl_gc_overflow_timout. 
$FLAG2: Hz(100). 


6.27 load_default 
Path: /proc/load_default 

Description: Enable/Disable load_default. 
Input Format: 

Echo “$FLAG” > /proc/ load_default 
Input Para: 

* 1: Enable load_default. 

* Q: Disable load_default. 
Output Format: 
Output Para: 


6.28 reInitSwitchCore 
Path: /proc/ reInitS witchCore 
Description: do rtl865x_reinitSwitchCore or not. 
Input Format: 

Echo “$FLAG” > /proc/ reInitS witchCore 
Input Para: 
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* 0: do nothing 

* non-zero value: rtl865x_reinitS witchCore 
Output Format: 

none 
Output Para: 


none 


Note: not supported in kernel 3.10. 


6.29 br_mld Version 
Path: /proc/ br_mldVersion 
Description: the MLD Version supported. 
Input Format: 
Echo “$FLAG” > /proc/ br_mld Version 
Input Para: 
* 1: MLD version 1. 
* 2: MLD version 2. 
Output Format: 
$FLAG 
Output Para: 
* 1: MLD version 1. 
* 2: MLD version 2. 


6.30 jate 
Path: /proc/jate 


Description: this file is added for JATE (the Japan Approvals Institute for Telecommunications 


Equipment) test. This feature is disabled by default and will be enabled after defined 
“CONFIG _RTL_JATE_TEST” compile flag in /linux-2.6.30/drivers/net/rtl8 19x/rtl_nic.c(for kernel 
2.6) or /linux-3.10/drivers/net/rtl8 19x/rtl_nic.c(for kernel 3.10). 


Input Format: 
echo “$FLAG” > /proc/jate 
Input Para.: 


* 1: port setting command: 


echo port [port number] [mode] > /proc/jate 


the valid value of port number is 0 ~ 5,5 mean all ports. 
the valid value of mode is 10H/10F/100H/100F/Auto. 


for example: 
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echo port 0 10H > /proc/jate 
echo port 1 10F > /proc/jate 
echo port 2 100H > /proc/jate 
echo port 3 100F > /proc/jate 
echo port 5 Auto > /proc/jate 


* 2: packet transmitted command: 
echo tx [port mask] [packet type] [packet output time] [packet output interval] > 
/proc/jate 


the valid value of port mask are | ~ Ox1f, 1 means port 0, 2 means port 1, Ox1f means 
all ports 
the valid value of packet type are 0~2, 0: random data pattern, 1: all0 data pattern; 2: 
alll data pattern 
the valid value of packet output time is from 1 to 1000 (unit: second) 
the “packet output interval” argument is optional. Its default value is 50ms if this field 
is absent. The valid value is from 1 to 500 (unit: millisecond). 
for example: 
echo tx 1 0 600 > /proc/jate 
echo tx 2 1 500 100 > /proc/jate 
echo tx 1f 2 2000 500 > /proc/jate 


Output Format: 
none 
Output Para.: 


none 


6.31 gpio_ctrl 
Path: /proc/wlan0/gpio_ctrl 
Description: GPIO control for 8188ER, 8192CE, 8188RE, 8192D 
Input Format: 
Echo $CMD $GPIO $ACT > /proc/wlan0/gpio_ctrl 
Input Para: 
1) $CMD: 
* config: Config GPIO pins to be input or output 
* set: Write value to specified GPIO pin 
2) $GPIO: 
* Q~11: Specify GPIO pin number 
3) $ACT: 
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* r/w: When $CMD is config, specify GPIO pin to be input or output 
* 0/1: When $CMD is set, write value to GPIO pin 
Output Format: 
GPIO$M $N 
Output Para: 
1) $M: 
* Q~11: The GPIO pin which is specified as input 
2) $N: 
* 0/1: The GPIO status of the GPIO pin 


for example: 


echo config 4 w > /proc/wlanO/gpio_ctrl (Config GPIO 4 to be output pin) 
echo set 4 1 > /proc/wlan0/gpio_ctrl (Set GPIO 4 output high) 
echo set 4 0 > /proc/wlan0/gpio_ctrl (Set GPIO 4 output low) 


6.32 Jumbo frame support 
Path: /proc/jumbo_frame_support 
Description: It controls jumbo frame setting on switch core. 
Input Format: 
Echo $FLAG $SIZE > /proc/ jumbo_frame_support 
Input Para: 
1) $ FLAG: 
* 0: disable jumbo frame support 
* 1: enable jumbo frame support 
2) $ SIZE: 
* 9000: Specify max length of jumbo frame supported. 
* 16000: Specify max length of jumbo frame supported. 
Output Format: 
None 
Output Para: 


None 


for example: 
1) Set AP to support 9K jumbo frame 
echo 1 9000 > /proc/jumbo_frame_support 


/*Don't forget to change interface's mtu accordingly when enable jumbo frame*/ 
ifconfig ethO mtu 9216 
ifconfig brO mtu 9216 
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ifconfig ethl mtu 9216 


2) Set AP to support 16K jumbo frame 
echo 1 16000 > /proc/jumbo_frame_support 


/*Don't forget to change interface's mtu accordingly when enable jumbo frame*/ 
ifconfig ethO mtu 16370 

ifconfig brO mtu 16370 

ifconfig ethl mtu 16370 


3) disable jumbo frame support 


echo 0 0 > /proc/jumbo_frame_support 


/*Don't forget to change interface's mtu accordingly when disable jumbo frame*/ 
ifconfig brO mtu 1500 

ifconfig ethO mtu 1500 

ifconfig ethl mtu 1500 


6.33 port_status 
Path: /proc/rtl865 x/port_status 
Description: display Ethernet port status (cat /proc/rtl865x/port_status) or set Ethernet port speed 
and duplex mode (echo ... > /proc/rtl865x/port_status). 
Input Format: 
echo port $PORT_MASK $MODE > /proc/rtl865x/port_status 
Input Para: 
1) $PORT_MASK: 
decimal format 
bit 0 ~ 4: port 0 ~ 4 
2) $MODE: 
10_half: 10M half-duplex 
10_full: 10M full-duplex 
100_half: 100M half-duplex 
100_full: 100M full-duplex 
1000_half: 1000M half-duplex 
1000_full: 1000M full-duplex 
an_10m: Auto-Negotiation to 10M half/full-duplex 
an_100m: Auto-Negotiation to 1OM/100M half/full-duplex 


the other character: auto 


©2011 Realtek Semiconductor Corp. 302 


Output Format: 
None 
Output Para: 


None 


for example: 
echo port 17 10_full > /proc/rtl865x/port_status 
==> set port 0 and port 4 to "10M full-duplex" (17 = 0x11, bit 4 and bit 0 = 1) 


6.34 StormCtrl 
Path: /proc/StormCtrl 


Description: Enable/Disable multicast storm control function and set multicast storm control rate 
to all physical port. 
Input Format: 
echo $RATE_PERCENTAGE > /proc/ StormCtrl 
Input Para: 
$ RATE_PERCENTAGE: 
Positive integer 
Input between 0 and 100 will set storm control rate in proportion to maximum link speed. 
Input over 100 will disable storm control. 
Output Format: 
None. 
Output Para: 
None. 
for example: 
echo 60 > /proc/ StormCtrl 


==> for 100M port, each port will limit the max rate of incoming multicast packets to 60M. 


6.35 phyReg 
Path: /proc/rtl865 x/phyReg 


Description: read/write PHY register. 


@ For embedded PHY and external single PHY IC (for example: 8211E/8211F) 
Input Format: 

echo read [phy_id] [reg] > /proc/rtl865x/phyReg 

echo write [phy_id] [reg] [data] > /proc/rtl865x/phyReg 
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echo extRead [phy_id] [page] [reg] > /proc/rtl865x/phyReg 

echo extWrite [phy_id] [page] [reg] [data] > /proc/rtl865x/phyReg 
Input Para: 
1) phy_id: 

For 8197F and 8198C: phy id is 8/1/2/3/4 for port 0/1/2/3/4. 

For the other SoC: phy id is 0/1/2/3/4 for port 0/1/2/3/4. 

For external single PHY IC: the phy id is decided by hardware. 


@ For external Switch IC 8367RB 
Input Format: 
echo 8367phyr [phy_id] [reg] > /proc/rtl865x/phyReg 
echo 8367phyw [phy_id] [reg] [data] > /proc/rtl865x/phyReg 


@ For external Switch IC 8370 
Input Format: 
echo 8370phyr [phy_id] [reg] > /proc/rtl865x/phyReg 
echo 8370phyw [phy_id] [reg] [data] > /proc/rtl865x/phyReg 


@® For external Switch IC 8325D 
Input Format: 
echo 8325phyr [phy_id] [reg] > /proc/rtl865x/phyReg 
echo 8325phyw [phy_id] [reg] [data] > /proc/rtl865x/phyReg 


@ RTCT (RealTek Cable Test) 
Command: echo rtct > /proc/rtl865x/phyReg 


test output example: 


RICT test result: 

Port# Channel Cable status "Distance to abnormal point" 
[9] A Normal (Link up) - 

[0] B Normal (Link up) - 

[1] A Open <= 4 meter 
[1] B Open <= 4 meter 
[2] A Short 7 meter 
[2] B Short 7 meter 
[3] A Impedance mismatch (<75 ohm) 28 meter 
[3] B Impedance mismatch (<75 ohm) 28 meter 
[4] A Impedance mismatch (>150 ohm) 50 meter 
[4] B Impedance mismatch (>150 ohm) 50 meter 


* Output fields description: 
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>  Port#: RTL8197F embedded physical port 0 ~ 4 
>» Channel: channel A and B for each port. 
>  Cable_status: 
@ Port link up: 
@ Always show “Normal (Link up)” 
@ Port link down: 


@ Open 

@ = Short 

@ Impedance mismatch (<75 ohm) 
@ Impedance mismatch (>150 ohm) 


@ Unknown 
>» Distance to abnormal point: 
@ Normal (Link up): 
@ Always show 
@ Open/Short/Impedance mismatch/Unknown: 


@ Show the distance to abnormal point 


oo 99 


* ~=Test method: 
> Normal case: 8197F port connect to a link partner and link up. 
> Open case: 
@ Ifthe 8197F port does not connect with any cable, the RTCT result will show Open 
and length <= 4 meter. 
@ take different length RJ45 cable, one side connect to 8197F port, the other side does not 
connect to anything. 
> Short case: take different length RJ45 cable, one side connect to 8197F port, the other side 
connect to the test equipment “short” port. 
> Impedance mismatch case: take different length RJ45 cable, one side connect to 8197F port, 
the other side connect to the test equipment “75Q” or “150Q” port. 
> Unknown: take a 200 meter length RJ45 cable, one side connect to 8197F port, the other side 


does not connect to anything. 


* Limitation: the RTCT function is only for 0 to 120 meter cable. The test result can't be diagnosed 
correctly if cable length is longer than 120 meter. 


@ PHY Diagnostic 


Command: echo diag > /proc/rtl865x/phyReg 


test output example: 
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****® Extract the PHY Diagnostic Information **** 


Port# Link Speed 100M_SNR PowerDown AN-mode AN-Cap ability ability 
(local) (remote) (local) (remote) 

[9] Up i0F - No AN Yes {0,0,1,1} {1,144,433 

[1] Down - - PowerDown Force No oe Spe Fey hee Fe NA 

{2] Down - - No AN No {1,1,1,1} NA 

{3] Up 100F 1249 No AN Yes €1, 3,423 353,532,433 

[4] Down - - No AN No {1,1,1,1} NA 


## NOTE: ability(local/remote): is the bitmap of {100F 100H 10F 10H} 
snr value translating to dB value is by: -(10 * logi0(snr/pow(2,18))) 
* Output fields description: 
>  Port#: RTL8197F embedded physical port 0 ~ 4 
> Link: phy link up or link down. 
> Speed: link speed and duplex for link up case, it should be 100F/100H/10F/10H. 
>  100M_SNR: the SNR value for link up and link speed 100Mbps case. 

Due to Linux kernel has no log10 function, we do not show the SNR dB value. However the 
SNR value can translate to dB value thru this formula: “-(10 * log10(snr/pow(2,18)))”. A SNR of 
less than 21 dB is considered to be poor with a strong likelihood of causing data errors. 
> | PowerDown: phy is power down or not. 


AN-mode (local): local phy is configured as Auto-Negotiation mode or Force mode. 


Ability (local): the bitmap represent { 100F 100H 10F 10H }. 


> 

>» AN-Cap (remote): remote phy’s AN-capability is Auto-Negotiation mode or Force mode. 
> 

> Ability (remote): when the phy is link up, the bitmap represent { 100F 100H 10F 10H }. 
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7 FAQ 


7.1 How to modify the mappings of LAN/WAN port? 

Modify linux-2.6.30/include/net/rtl/rtl865 x_netif.h(for kernel 2.6) or linux-3.10/include/net/rtl 
/rtl865x_netif.h (for kernel 3.10), and define RTL_WANPORT_MASK and RTL_LANPORT_MASK 
as needed. 


RTL_LANPORT_MASK_x (xis 1,2,3,4) should be adjust also if 
CONFIG_RTL_MULTI_LAN_DEV enabled. 


For example: change wan port to port 0 


#define RTL_WANPORT_MASK 0x01 
#define RTL_LANPORT_MASK Oxl1E 
#define RTL_LANPORT_MASK_ 1 0x10 
#define RTL_LANPORT_MASK_ 2 0x08 
#define RTL_LANPORT_MASK _ 3 0x04 
#define RTL_LANPORT_MASK _ 4 0x02 


In 8367 platform, if RTL83XX_WAN is not defined,please change the “RTL8367R_WAN” 
definition in /$Kernel_dir /drivers/net/rtl819x/AsicDriver/rtl865xc_asicregs.h and 


/$Kernel_dir /drivers/net/rtl8 19x/rtl8367r/rtk_api.c. 
In 8363 platform, please change the “RTL83XX_WAN” definition in 
/$Kernel_dir /drivers/net/rtl8 19x/AsicDriver/rtl865xc_asicregs.h and 


/$Kernel_dir /drivers/net/rtl8 19x/rtl83xx/rtk_api.c. 


$Kernel_dir for kernel 2.6.30 Kernel_dir = linux-2.6.30 


$Kernel_dir for kernel 3.10 Kernel_dir = linux-3.10 


7.2 How to change the baud rate of console? 
Modify bootloader code file btcode/start.h and boot/init/utility.h, define BAUD_RATE as needed. 
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7.3 How to use vlan priority option of iptables? 


Firstly, Linux kernel configure as follows: 
(@) Networking support ---> 
Networking options ---> 
Network packet filtering framework (Netfilter) ---> 
Core Netfilter Configuration ---> 
"VLAN" match support //Selected 
(2) Networking support ---> 
Networking options ---> 
Network packet filtering framework (Netfilter) ---> 
Core Netfilter Configuration ---> 


"VLAN" match support //Selected 
Qos support vlan priority //Selected 


Secondly » one example of iptables rule using vlan priority option as follows: 
// Mapping all the packets with vlan priority 3 to skb MARK 13 
iptables -A PREROUTING -t mangle -m vlanpriority --prio-value 3 -; MARK --set-mark 13 


7.4 Relationship of virtual AP and root AP? 


Relationship of virtual AP and root AP is as follows: 
(4) Since there is only one wireless IC, virtual AP and root AP use the same hardware. 


(2) Boot sequence of our AP is that root AP is initialized firstly and virtual AP is initialized 
then. 


(3) Hardware settings of virtual AP such as band and channel should be subset of root AP 
hardware settings. Since our hardware support multiple data rate at the same, data rate of 
virtual AP can be set different from root AP. 


(4) Since virtual AP is also the software AP of our AP, the software settings of virtual AP 
such as SSID, WMM, ACCESS, ENCRYPTION etc can be set different from root AP. 
7.5 How to customize icon of Ild2d? 
Steps to customize icon of Ild2d as follows: 
(4) Add Icon, and install to /etc/ 


(2) Modify Id2d.conf, set "jumbo-icon" value, and install 11d2d.conf to /etc/ 
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One example to customize icon of Ild2d as follows: 
(1) Add Icon: realsil_gw.ico, Install to /etc/realsil_gw.ico 
(2) Modify Id2d.conf: jumbo-icon = /etc/realsil_gw.ico 
And install 1ld2d.conf to /etc/Ild2d.conf 


7.6 How to rename the AP when shown on Windows? 
Please input command “flash set DEVICE_NAME ‘name’ ” in console and then reboot AP. 


One example as follows: If you want AP show the name ‘BARL X48’ on Windows, do command 
“flash set DEVICE_ NAME BARL X48” in console, and then reboot AP. 


7.7 Howto add MAC address filter based on ether driver API? 
1) Solution 1: Use ACL rule to do source or destination MAC address filter. 


Program APIs as follows: 


int32 rtlS65x_add_acl(rtl865x_AclRule_t *rule, char *netifName,int32 priority) ; 
int32 rtlS65x_del_acl(rtl865x_AclRule_t *rule, char *netifName,int32 priority) ; 


Example code for solution 1 as follows: 


int32 retval; 
rtlS65x_AclRule_t rule; 


// To add acl rule for smac(00: 1e:c9:3b:b3:44) filter 
bzero((void*) &rule, sizeof(rule)); 

rule.ruleType_ = RTLS65X_ACL_MAC; 
rule.actionType_ = RTL865X_ACL_DROP; 
rule.pktOpApp_ = RTL865X_ACL_ALL_LAYER; 
rule.srcMac_.octet{0]=0x00; 
rule.srcMac_.octet[1 ]=Oxle; 
rule.srcMac_.octet[2 ]=Oxc9; 
rule.srcMac_.octet[3 ]=Ox3b; 
rule.srcMac_.octet[4]=Oxb3; 
rule.srcMac_.octet[5 ]=0x44; 


rule.srcMacMask_.octet{0]=OxFF; 
rule.srcMacMask_.octet[ 1]=OxFF; 
rule.srcMacMask_.octet[2]=OxFF; 
rule.srcMacMask_.octet[3]=OxFF; 
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rule.srcMacMask_.octet[4]=OxFF; 
rule.srcMacMask_.octet[5]=OxFF; 


retval= rtlS65x_add_acl(&rule, "br0", RTLS65X_ACL_SYSTEM_USED); 


// To del acl rule for smac(00: 1e:c9:3b:b3:44) filter 
bzero((void*) &rule, sizeof(rule)); 

rule.ruleType_ = RTLS65X_ACL_MAC; 
rule.actionType_ = RTL865X_ACL_DROP; 
rule.pktOpApp_ = RTL865X_ACL_ALL_LAYER; 
rule.srcMac_.octet{0]=0x00; 
rule.srcMac_.octet[1 ]=Oxle; 
rule.srcMac_.octet[2 ]=Oxc9; 
rule.srcMac_.octet[ 3 ]=0x3b; 
rule.srcMac_.octet[4 ]=Oxb3; 
rule.srcMac_.octet[5 ]=0x44; 


rule.srcMacMask_.octet[0]=OxFF; 
rule.srcMacMask_.octet[1]=OxFF; 
rule.srcMacMask_.octet[2]=OxFF; 
rule.srcMacMask_.octet[3]=OxFF; 
rule.srcMacMask_.octet[4]=OxFF; 
rule.srcMacMask_.octet[5 ]=OxFF; 


retval= rtlS65x_del_acl(&rule, "brO", RTLS65X_ACL_SYSTEM_USED); 


2) Solution 2: Use source block via hardware L2 table to do source MAC address filter. 
Program APIs as follows: 


int32 rtl865x_addFilterDatabaseEntryExtension (uint16 fid, rtl865x_filterDbTableEntry_t * L2entry); 
int32 rtl865x_delFilterDatabaseEntry (uint16 I2Type, uint16 fid, ether_addr_t * macAddr); 


Example code for solution 2 as follows: 
int32 retval; 
uint32 fid; 
rtlS65x_filterDbTableEntry_t [2temp_entry; 
ether_addr_t macAddr; 
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// To add hardware L2 table entry for smac(00:1e:c9:3b:b3:44) filter 
fid=RTL_LAN_FID; 

memset((void *)&l2temp_entry, 0, sizeof(l2temp_entry)); 

[2temp_entry.l2type = RTL865x_L2_TYPEII; 

[2temp_entry.process = FDB_TYPE_SRCBLK; 
[2temp_entry.memberPortMask = RTL_LANPORT_MASK; 
[2temp_entry.auth = FALSE; 

I2temp_entry.SrcBlk = TRUE; 


[2temp_entry.macAddr.octet{[0]=0x00; 
I2temp_entry.macAddr.octet[{ 1]=Oxle; 
[2temp_entry.macAdadr.octet[2]=0xc9; 
I2temp_entry.macAdadr.octet[3 ]=0x3b; 
[2temp_entry.macAddr.octet[4]=O0xb3; 
[2temp_entry.macAddr.octet[5]=0x44; 


retval=rtl865x_addFilterDatabaseEntryExtension(fid, &l2temp_entry); 


// To del hardware L2 table entry for smac(00:1e:c9:3b:b3:44) filter 
fid=RTL_LAN_FID; 


macAdadr.octet[0]=O0x00; 
macAddr.octet[{ 1 ]=Oxle; 
macAddr.octet[2 ]=Oxc9; 
macAddr.octet[ 3 ]=O0x3b; 
macAddr.octet[4]=Oxb3; 
macAddroctet[5 ]=0x44; 


retval = rtl865x_delFilterDatabaseEntry(RTL865x_L2_TYPEIUl, fid, &macAddr); 


7.8 How to adjust CPU speed? 


For hardware designer, please refer to Fig 7.8.1 and adjust signal MA11~9 (CPUCIkSel[2:0]) to 
select CPU clock from 250MHz, 270 MHz, 290 MHz, 310 MHz, 330 MHz, 350 MHz, 370 MHz and 
390 MHz. 
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Fig 7.8.1 Realtek 802.11n 10/100M Wireless Router Interface Circuit 


7.9 How to shutdown power of Ethernet ports? 


1) For hardware designer, please refer to Fig 7.8.1 above and modify as follows: 
Set MA13=0: port0~3 closed and only port4 opened. 
Set MA13=1: port0~4 opened. 


2) For software designer, “#define CONFIG_RTL_PHY_POWER_CTRL” in 
linux-2.6.30/include/net/rtl/rtl_nic.h(for kernel 2.6) or linux-3.10/include/net/rtl/rtl_nic.h(for kernel 
3.10), rebuild image and update it to AP. 


After AP boots up, control the power of Ethernet ports as follows: 


echo "portmask phystats" > /proc/phyPower //0: power off; 1: power on. 
For example: 

echo "Ox1f 1" > /proc/phyPower // set portO~port5 power on, dont change other port status. 

echo "0x03 1" > /proc/phyPower // set Ethernet portO and port] power on, don't change other port 
status. 


echo "0x03 0" > /proc/phyPower // set Ethernet portO and portl power off, dont change other port 
status. 
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7.10 How to disable Ethernet PHY? 


Solution: 
1) bitO of Port Configuration Register set to 0. 
2) Use API rtl865x_disableDevPortForward at linux-2.6.30/driver/net/rtl8 1 9x/rtl_nic.c(for 
kernel 2.6) or linux-3.10/driver/net/rtl8 19x/rtl_nic.c(for kernel 3.10) 


7.11 Which channels are supported by RTL8192D? 


Answer: 
1) Channels of 2.4G Band supported by RTL8192D are listed as follows. 
Note: 

at present, there aren’t so many channel number supported at the webpage of AP, the reason is 
that the webpage is just for demo. The webpage of AP can be customized to support all the channel 
number which are supported by RTL8192D. 
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2) Channels of 5G Band supported by RTL8192D are listed as follows. 
Note: 

at present, there aren’t so many channel number supported at the webpage of AP, the reason is 
that the webpage is just for demo. The webpage of AP can be customized to support all the channel 
number which are supported by RTL8192D. 
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7.12 How to set speed and duplex of physical port via APIs? 


Answer: 
In order to set speed and duplex of physical port, the related APIs are as follows: 
1) int32 rtl865xC_setAsicEthernetForceModeRegs (uint32 port, uint32 enForceMode, 
uint32 forceLink, uint32 forceSpeed, uint32 forceDuplex); 
2) int32 1tl8651_setAsicEthernetPH YS peed (uint32 port, uint32 speed); 
3) int32 rtl8651_setAsicEthernetPH Y Duplex( uint32 port, uint32 duplex ); 
4) int32 rtl8651_setAsicEthernetPH YAutoNeg( uint32 port, uint32 autoneg); 
5) int32 rtl8651_setAsicEthernetPH YAdvCapality(uint32 port, uint32 capality); 
6) int32 rtl8651_restartAsicEthernetPH YN way (uint32 port); 


One example to set port 2 at forcemode duplex 100Mbps as follows: 


#define SPEED10M 0 
#define SPEEDIOOM 1 
#define SPEEDIOOOM 2 


enum 

{ 
PORT_DOWN=0, 
HALF_DUPLEX_10M, 
HALF_DUPLEX_100M, 
HALF_DUPLEX_1000M, 
DUPLEX_10M, 
DUPLEX_100M, 
DUPLEX_1000M, 
PORT_AUTO 

i 


/* Customized */ 

uint32 port=2; 

int forceMode=TRUE; 

int forceLink=TRUE; 

int forceLinkSpeed=SPEED 100M; 

int forceDuplex=TRUE; 

uint32 advCapability=(1<<DUPLEX_100M); 


rtl865xC_setAsicEthernetForceModeRegs(port, forceMode, forceLink, forceLinkSpeed, 
forceDuplex); 

rtl865 1_setAsicEthernetPH YSpeed(port, forceLinkS peed); 

rtl865 1_setAsicEthernetPH Y Duplex(port,forceDuplex); 

//Note: if use force mode, auto negotiation must be disabled. 

rtl865 1_setAsicEthernetPH YAutoNeg (port, FALSE); 

rtl865 1_setAsicEthernetPH YAdvCapality (port,advCapability); 

rtl8651_restartAsicEthernetPH Y Nway (port); 


7.13 How to dial up pppoe for test when wan interface is changed? 


Answer: 
One example, interface usb_3¢g is used as wan interface to dial up pppoe. 
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For test, pppoe script (named pppoe_test.sh for example) can be used as follows: 
#!/bin/sh 
WAN=$2 
OPTIONS=/etc/ppp/options 
PAPFILE=/etc/ppp/pap-secrets 
CHAPFILE=/etc/ppp/chap-secrets 
RESOLV=/etc/ppp/resolv.conf 
LINKFILE=/etc/ppp/ink 
PPPFILE=/var/run/ppp 
FIRSTFILE=/etc/ppp/first 
FIRSTDEMAND=/etc/ppp/firstdemand 
CONNECTFILE=/etc/ppp/connectfile 
DNRDPIDFILE=/var/run/dnrd.pid 


# Customized here for test 

eval ‘flash set WAN_DHCP 3° 

eval ‘flash set PPP_USER_NAME "zj2"* 
eval ‘flash set PPP_PASSWORD "123" 
eval ‘flash set PPP_IDLE_TIME 300° 
eval ‘flash set PPP_CONNECT_TYPE 0° 
eval ‘flash set PPP_MTU_SIZE 1460° 
eval ‘flash set DNS_MODE 0° 

eval ‘flash set DNSI 0.0.0.0° 

eval ‘flash set DNS2 0.0.0.0° 

eval ‘flash set DNS3 0.0.0.0° 


eval ‘flash get WAN_DHCP* 

eval ‘flash get PPP_USER_NAME* 
eval ‘flash get PPP_PASSWORD~ 

eval ‘flash get PPP_IDLE_TIME™ 

eval ‘flash get PPP_CONNECT_TYPE* 
eval ‘flash get PPP_MTU_SIZE 

eval ‘flash get DNS_MODE* 

eval ‘flash get DNS1* 

eval ‘flash get DNS2~ 

eval ‘flash get DNS3* 


ifconfig $WAN 0.0.0.0 
if [ $1 = 'connect' ]; then 
ENABLE_CONNECT=1 
else 
ENABLE_CONNECT=0 
fi 
if [ -n "$PPP_USER_NAME" ] ; then 
echo "name \"$PPP_USER_NAME\"" > $OPTIONS 
echo "HHHHHHHHHHHHHHHHHHHHHHHHH HAH HAHHHHH HEHEHE HH HEH HH SS DA PETITE 


echo '\"$PPP_USER_NAME\" . \"$PPP_PASSWORD\"" >> $PAPFILE 
echo "FEEAAEEHHEE TEE TEA TEE EA TET TEE ee > SCHAPFILE 
echo '\"$PPP_USER_NAME\" . \"$PPP_PASSWORD\"" > > $CHAPFILE 


fi 


echo "noauth" >>$OPTIONS 

echo "nomppc" >>$OPTIONS 

echo "noipdefault" >> $OPTIONS 
echo "hide-password" >> $OPTIONS 
echo "defaultroute" >> $OPTIONS 
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echo "persist" >> $OPTIONS 

echo "ipcp-accept-remote" >> $OPTIONS 
echo "ipcp-accept-local" >> $OPTIONS 

echo "nodetach" >>$OPTIONS 

echo "usepeerdns" >> $OPTIONS 

echo "mtu $PPP_MTU_SIZE" >> $OPTIONS 
echo "mru $PPP_MTU_SIZE" >> $OPTIONS 
echo "Icp-echo-interval 20" >> $OPTIONS 
echo "Icp-echo-failure 3" >> $OPTIONS 
echo "wantype $WAN_DHCP" >> $OPTIONS 
echo "holdoff 10" >> $OPTIONS 


if [ -n "$PPP_SERVICE_NAME" ]; then 
echo "plugin /etc/ppp/plugins/libplugin.a rp_pppoe_service $PPP_SERVICE_NAME $WAN" >> 
SOPTIONS 
else 
echo "plugin /etc/ppp/plugins/libplugin.a $WAN" >> $OPTIONS 
fi 


PID_FILE=/var/run/ppp0.pid 
DNRD_PID=/var/run/dnrd.pid 


if[ !-f$DNRD_PID ]; then 
DNS="--cache=off" 
if [ $3DNS_MODE != 1 ]; then 
dnrd $DNS -s 168.95.1.1 
fi 
if [ S3DNS_MODE = 1 ]; then 
if [ "$DNS1" != '0.0.0.0' ]; then 
DNS="$DNS -s $DNS1" 
fi 
if [ "$DNS2" != '0.0.0.0' ]; then 
DNS="$DNS -s $DNS2" 
fi 
if [ "8DNS3" != '0.0.0.0' ]; then 
DNS="$DNS -s $DNS3" 
fi 
dnrd $DNS 
fi 
fi 


if [ -r "$PPPFILE" ]; then 
rm $PPPFILE 


fi 

killall -15 pppd 2> /dev/null 

if [ -r "SCONNECTFILE" ]; then 
rm -f $CONNECTFILE 

fi 

if [ $PPP_CONNECT_TYPE = 0 ] ; then 
while [ true ]; do 


if [ S;WAN_DHCP != 3 ]|| [ $PPP_CONNECT_TYPE != 0 ]; then 
break 
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fi 


if [!-r "SCONNECTFILE" ]  && [ $PPP_CONNECT_TYPE = 0 ]; then 
echo "pass" > $CONNECTFILE 


if [ ! -f $FIRSTFILE ]; then 
echo "pass" > $FIRSTFILE 
fi 


pppd 
fi 
sleep 5 
done 


rm -f $FIRSTFILE 
/& 
fi 


if [ $PPP_CONNECT_TYPE = 1 ] ; then 
{ 
echo "demand" >> $OPTIONS 

echo "idle $PPP_IDLE_TIME" > > $OPTIONS 


while [ true ]; do 


if [ $;WAN_DHCP != 3 ] || [$PPP_CONNECT_TYPE != 1 ]; then 
break 


fi 
if [ !-r "SCONNECTFILE" ]_ && [ $PPP_CONNECT_TYPE = 1 ]; then 


echo "pass" > $CONNECTFILE 
if [ | -f 8FIRSTDEMAND J; then 


echo "pass" > $FIRSTDEMAND 
fi 


ppd 
if [ -f S3DNRDPIDFILE ]; then 


PID= ‘cat $DNRDPIDFILE* 
kill -9 $PID 
rm -f $3DNRDPIDFILE 
fi 
dnrd --cache=off -s 168.95.1.1 
fi 
sleep 5 
done 


rm -f $FIRSTDEMAND 
}& 
fi 


if [ $PPP_CONNECT_TYPE = 2 ]; then 


if [ S$ENABLE_CONNECT = 1 ]; then 
pppd & 


fi 
fi 
Test steps as follows: 


Step 1): add pppoe_test.sh as above in users/script/cinit/. 
Step 2): make sdk and update image. 


Step 3): after AP boots up, at AP console, input command as follows: 
/bin/sh -x /bin/pppoe_test2.sh all usb_3g & 


Test result: pppoe should dial up via wan interface usb_3g. 


©2011 Realtek Semiconductor Corp. 


318 


Debug: 
At AP console, cd /etc/ppp/ and check settings for pppoe as follows: 
1) chap-secrets and pap-secrets is secret settings, one example as follows: 
# cat chap-secrets 
PEPER TERE HEHEHE HEE EET PEE EEE EE 
i Pa i 
# cat pap-secrets 
SEE PEEE TERETE EEE PETE EET TEE EEE EE 
4 123" 
2) options is config settings for pppoe, one example as follows: 
# cat options 
name "zj2" 
noauth 
nomppc 
noipdefault 
hide-password 
defaultroute 
persist 
ipcp-accept-remote 
ipcp-accept-local 
nodetach 
usepeerdns 
mtu 1460 
mru 1460 
Icp-echo-interval 20 
Icp-echo-failure 3 
wantype 3 
holdoff 10 
plugin /etc/ppp/plugins/libplugin.a eth] 


7.14 How to enable/disable ipv6 passthru? 


Answer: 
Note: when enable ipv6 passthru, all ipv6 protocol stack should be disabled in menuconfig, 
otherwise ipv6 passthru will be test fail. 


1.1) At gateway mode, enable ipv6 passthru as follows: 
ifconfig pethO up 
brctl addif brO pethO 
echo "1">/proc/custom_Passthru 

1.2) At gateway mode, disable ipv6 passthru as follows: 
echo "0">/proc/custom_Passthru 
brctl delif brO pethO 
ifconfig pethO down 

2.1) At WISP mode, enable ipv6 passthru as follows: 
ifconfig pwlanO up 
brctl addif brO pwlanO 
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echo $value > /proc/custom_Passthru_wlan 
where the $value is as follows: 
a) For single band: 
If repeater mode is enabled, $value = 1 | 0x8 = 9; 
else $value = 1; 
b) For dual band: 
If repeater! enabled or repeater2 enabled, 
$value=1 |0x8|((wisp WanId&0xF)< <4), 
else 
$value=1 |((wispWanId&0xF)<<4). 
For example: 
Repeater! is enabled, and wispWanId=0, 
$value=1 |((O&0xF)<<4)|0x8=9. 
Note: for WISP mode, in order to use ipv6 passthru, nat2.5 should also be enabled, otherwise 
ipv6 passthru will fail. Enable nat2.5 as follows: 
ifconfig wlan0 down 
iwpriv wlanO set_mib nat25_disable=0 
ifconfig wlanO up 
2.2) At WISP mode, disable ipv6 passthru as follows: 
echo "0" > /proc/custom_Passthru_wlan 
brctl delif brO pwlanO 


ifconfig pwlan0 down 


7.15 Please explain “Support multi-vlan in bridge/wisp mode” at kernel? 
Answer: 
Menu “Support multi-vlan in bridge/wisp mode” is at linux menuconfig as follows: 

Device Drivers ---> 

[*] Network device support ---> 
[*] | Options for Realtek SoC ---> 
Config for Layered Driver Features ---> 
[*] Support multi-vlan in bridge/wisp mode 

“Support multi-vlan in bridge/wisp mode” is implemented by macro CONFIG_RTL_IVL 
_SUPPORT. 

When AP is changed to bridge/WISP mode, the original wan port is added into br0. 

If CONFIG_RTL_IVL_SUPPORT is enabled, the original wan port vlan id is set to 8 and 
the other lan port vlan id is set to 9, so the traffic between the lan port and the original wan port 
will be software forwarded via CPU. 

If CONFIG_RTL_IVL_SUPPORT is disabled, the original wan port and the other lan port is 


set to the same vlan id, so the traffic between the lan port and the original wan port will be 
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hardware forwarded. 


7.16 How to add/update flash MIB entry at the web-server? 
Answer: 
1) Introduction of flash MIB 
The flash MIB is used for system configuration. 
The flash MIB can be accessed via webpage or flash tool. The flash tool is a method to manage the 
flash MIB via console. 
In flash layout, there are three MIB settings: HW Settings, Default Settings and Current Settings. 
-- HW Settings 
The HW settings are the parameter settings of the hardware, such as RF power index. Usually, 
they are set via MP tools. 
-- Default Settings 
The Default settings are backup settings. When you click "Reset to Default" button on webpage, 
or input console command "flash default-sw", the Current settings will be replaced by the Default 
settings. 
The Program-default settings are hardcode settings at the function writeDefault() in flash.c. 
-- Current Settings 
The Current settings are current user settings. 
2) Steps to add flash MIB entry 
Step 1, in users/goahead-2.1.1/LINUX/apmib.h or users/boa/apmib/apmib.h if Boa web server is 
selected, create new MIB define. The MIB ID defined by users should be 16000~32767 (1~15999 for 
Realtek) . 
Ex: 
#define MIB_WLAN_11N_ONOFF_TKIP 660 
Step 2, in users/goahead-2.1.1/LINUX/mibdef.h or users/boa/apmib/mibdef.h if Boa web server is 
selected, create new member in "config_setting" or in "config_wlan_setting". There are flags 
MIB_IMPORT for "config_setting" and MIB_CONFIG_WLAN_SETTING_IMPORT for 
"config _wlan_setting". Please insert the new MIB entry to the proper table. 
Ex: 
#ifdef MIB_IMPORT 


MIBDEF (unsigned char, wlanl1nOnOffTKIP,, WLAN_11N ONOFF_TKIP, 
BYTE_T, APMIB_T, 0, 0) 


#endif /*MIB_IMPORT */ 
Step 3, in users/goahead-2.1.1/LINUX/flash.c or users/boa/utils/flash.c if Boa web server is 
selected, add program-default value for new MIB entry at function writeDefault(). 
Step 4, in users/goahead-2.1.1/LINUX/upmib.h or users/boa/apmib/upmib.h if Boa web server is 
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selected, upgrade MIB VERSION value if step 5 exist. 
Ex; 
{MIB_MIB_VER, "MIB_VER", "2"}, 

Step 5, in users/goahead-2.1.1/LINUX/upmib.h or users/boa/apmib/upmib.h if Boa web server is 
selected, set new MIB default value in UPMIB_T new_mib[] before {0} if needed. 

Ex; 
{MIB_WLAN_11N_ONOFF_TKIP,  "WLAN_11IN_ONOFF_TKIP", "1"} 
3) Steps to update the current setting of flash MIB entry 

Step 1, in users/goahead-2.1.1/LINUX/upmib.h or users/boa/apmib/upmib.h if Boa web server is 

selected, upgrade MIB VERSION value if step 2 exist. 
Ex: 
{MIB_MIB_VER, "MIB_VER", "3"}, 

Step 2, in users/goahead-2.1.1/LINUX/upmib.h or users/boa/apmib/upmib.h if Boa web server is 
selected, update the current setting of the existed MIB entry in UPMIB_T update_mib[] before {0} if 
needed. 

Ex: 
{MIB_IP_ADDR, "IP_ADDR", "192.168.1.1"} 
4) Note 
* Any of following conditions may cause the HW settings or Default settings become 
program-default settings. 
a. The Setting signature in flash is not equal to setting signature in firmware. 
b. The Setting version in flash is not equal to setting version in firmware. 
* Any of following conditions may cause the Current settings replaced by Default settings. 
a. The Setting signature in flash is not equal to setting signature in firmware. 
b. The Setting version in flash is not equal to setting version in firmware. 
* The id in struct upmib is the same as the defination in apmib.h. The name in struct upmib is the 
same as the defination in mibdef.h 
* The new MIB value will be "0" or "" if you don't change the MIB version, and the specific MIB 
value won't be updated. 
* Users can delete the unnecessary MIB in UPMIB_T update_mib[] and UPMIB_T new_mib[] at 
the next firmware version. If the MIB version is changed, All the MIB in the two struct will be 


upgrade when upload firmware. 


7.17 How to modify flash MIB settings using the configure file uploaded via 
webpage? 
Answer: 
The configure files are stored at users/goahead-2.1.1/LINUX or users/boa/defconfig if Boa web 
server is selected which are named after config-*.txt. For example, config-gw-96c.txt is the configure 


file for 96C+92C demo board. At the end of make image, the configure file will be converted into 
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config-*.dat (ex: config-gw-96c.dat) which can be uploaded via webpage. 
According to section 7.16, in flash layout, there are three MIB settings: HW Settings, Default 
Settings and Current Settings. 
Similarly, there are HW Settings, Default Settings and Current Settings in the configure file. 
HW Settings are named after HW_*, such as: HW_NICO_ADDR. 
Default Settings are named after DEF_*, such as: DEF_IP_ADDR. 
The rest MIB entries are Current Settings. 
We can modify any of the flash MIB setting in the configure file, then rebuild image and the 
configure file config-*.dat will be generated. 
After the configure file config-*.dat is uploaded via webpage, all the flash MIB settings will be 
replaced by the configure file. 


7.18 How to modify webpages at the web-server? 


Answer: 
The steps to modify webpages at the web-server as follows: 
Step 1, in users/goahead-2.1.1/web-gw, or users/boa/html if Boa web server is selected. 
a. Add new page. 
b. Add new link at code.asp or code.htm if Boa web server is selected 
c. Create new page as *.asp or *.htm if Boa web server is selected 


Step 2, in users/goahead-2.1.1/web-gw /*.asp or users/boa/html/*.htm if Boa web server is 
selected, dynamic values are generated and MUST be within "<% getInfo('value name’); %>". 


And in users/goahead-2.1.1/LINUX/fmget.c or users/boa/src/fmget.c if Boa web server is selected, 
add the return value by apmib_get() in "getInfo" function. 


Step 3, in users/goahead-2.1.1/web-gw /*.asp or in users/boa/html/*.htm if Boa web server is 
selected, add form action which post the settings of webpages to c code. 


Ex: in users/goahead-2.1.1/web-gw/tcpipwan.asp, add source code as follows, 
<form action=/goform/formWanTcpipSetup method=POST name="tcpip"> 


</form> 


Boa example: in users/boa/html/tcpipwan.htm, add source code as follows, 


<form action=/boafrm/formWanTcpipSetup method=POST name="tcpip"> 


©2011 Realtek Semiconductor Corp. 323 


</form> 


And in users/goahead-2.1.1/LINUX/fm*.c, find or add new goform function (ex: 
formWanTcpipSetup) to handle the settings post from webpage. If Boa web server is selected, in 
users/boa/src/fm*.c, find or add new boafrm function (ex: formWanTcpipSetup) to handle the settings 
post from webpage. Usually, save the new setting to flash by apmib_set(). 


Step 5, re-build the image. 


Note: the webpages will be decompressed in /var/webs when system boots up. 


7.19 How to build image which can run in ICE? 


Answer: 
The steps to build image which can run in ICE as follows. 


Step 1, defined CONFIG_USING_JTAG in linux-2.6.30/drivers/char/rtl_gpio.c(for kernel 2.6) or 
linux-3.10/drivers/char/rtl_gpio.c(for kernel 3.10) 


Step 2, remove CONFIG_RTL865X_BICOLOR_LED code in rtl_nic.c 
#if 0 

#if defined (CONFIG_RTL865X_BICOLOR_LED) 
#ifdef BICOLOR_LED_VENDOR_BXXX 
REG32(LEDCR) F (1 << 19); //5 ledmode set to | for bi-color LED 
REG32(PABCNR) &= ~0x001f0000; /* set port port b-4/3/2/1/0 to gpio */ 
REG32(PABDIR) | 0x001f0000; /* set port port b-4/3/2/1/0 gpio direction-output */ 
#else 
//8650B demo board default: Bi-color 5 LED 
WRITE_MEM32(LEDCR, READ_MEM32(LEDCR) | 0x01180000 ); // bi-color LED 
#endif 
/* config LED mode */ 
WRITE_MEM32(SWTAA, PORTS5_PHY_CONTROL); 
WRITE_MEM32(TCRO, 0x000002C2); //8651 demo board default: 15 LED boards 
WRITE_MEM32(SWTACR, CMD_FORCE | ACTION_START); // force add 
#else /* CONFIG_RTL865X_BICOLOR_LED */ 


/* config LED mode */ 
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WRITE_MEM32(LEDCR, 0x00000000 ); // 15 LED 
WRITE_MEM32(SWTAA, PORTS_PHY_CONTROL); 
WRITE_MEM32(TCRO, 0x000002C7); //8651 demo board default: 15 LED boards 
WRITE_MEM32(SWTACR, CMD_FORCE | ACTION_START); // force add 
#endif /* CONFIG_RTL865X_BICOLOR_LED */ 
#endif 
Step 3, modify ARCH_CPU_SLEEP default value to 'N' in boards/rtl8 196c/config.in 
config ARCH_CPU_SLEEP 
bool 
default n 
make menuconfig and load default value. 
Step 4, close watchdog at linux kernel menuconfig 
System Configuration ---> 
Enable watchdog timer support [] 
Step 5, re-build image. 
Step 6, load linux-2.6.30/vmlinux(for kernel 2.6) or linux-3.10/ vmlinux (for kernel 3.10) into 
ICE and run it. 


7.20 The image size and free memory info for RTL8198 + RTL8192C SDK. 


Answer: 


RTL8198 + RTL8192C demo board v610 run SDK v2.5 image (2011-06-07), the test result as 
follows. 


Configure \  Testentry | Config.dat(B) fw.bin (KB) MemFree (KB) 
Default 9197 2006 16420 
Enable samba 9252 2900 13736 
Enable DLNA 9252 2949 15056 


SDK v2.5 boot loader size 


Configure Boot. Bin(B) 
96c 22006 
96c_92d 22006 
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98 24158 


7.21 The summary of the HW feature for ICs till now. 


Answer: 
96C: HW multicast/Dump Switch 
93: HW NAT/HW Multicast 
96CT/98T: © HW NAT/Multicast/Qos & All Nat 
97: HW Miulticast/Qos 


7.22 Default values of RTL8196C SDK multicast and IPv6. 
Answer: 
Default values of RTL8196C SDK multicast and IPv6 as follows. 

/proc/br_mldsnoop: 1 

/proc/br_mldquery: 1 

/proc/br_igmpsnoop: 1 

/proc/br_igmpquery: 1 

Ipv6: disable 


7.23 How to configure to process IGMP reserve address? 
Answer: 
1) proc UI 
/proc/br_igmpDb 
2) command format 
echo "opCode devicename ipversion groupAddr forwardPortMask" > /proc/br_igmpDb 
(i) opCode: add/del 
(ii) deviceName:eth*/br0/all 
(ii1) ipversion: ipv4 or ipv6 
(iv) groupAddr: special multicast address 
(v) forwardPortMask: user specified forward port mask 
3) examples 
example 1: 
flood special address 224.1.2.3 if no client join 
echo "add all ipv4 224.1.2.3 Oxffffffff" > /proc/br_igmpDb 
example 2: 
block special address 224.1.2.3 if no client join 
echo "add all ipv4 224.1.2.3 0" > /proc/br_igmpDb 
example 3: 
del special address 224.1.2.3 record 
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echo "del all ipv4 224.1.2.3 0" > /proc/br_igmpDb 


example 4: 


default to flood ipv4 unknown multicast 


echo "add all ipv4 0.0.0.0 Oxffffffff" > /proc/br_igmpDb 


example 5: 


default to block ipv4 unknown multicast 


echo "add all ipv4 0.0.0.0 0x0" > /proc/br_igmpDb 


example 6: 


default to flood ipv6 unknown multicast 


echo "add all ipv6 0x0-0-0-0 OxFFFFFFFF" > /proc/br_igmpDb 


example 7: 


default to block ipv6 unknown multicast 


echo "add all ipv6 0x0-0-0-0 0x0" > /proc/br_igmpDb 
Notice ipv6 address must use the following format: 
OxAAAAAAAA-BBBBBBBB-CCCCCCCC-DDDDDDDDD 


4) Note 


If user dosen't specify the special multicast address or the default unknown multicast forwarding 


rule, the default process is as follows: 
239.255.255.250(upnp) is to be flooded, 
225.1.1.1(voip phone) is to be flooded, 
default to block unknown ipv4 multicast, 


default to flood unknown ipv6 multicast. 


7.24 How to modify flash offset of webpages/rootfs/kernel etc via linux 


menuconfig? 


Answer: 
make linux_menuconfig 
One example as follows: 
System Configuration ---> 
(0x200000) Size of Flash 
(0x6000) Hardware setting offset in flash. 
settings in flash 
(0x8000) Default setting offset in flash. 
settings in flash 
(OxCO00) Current setting offset in flash. 
image in flash 


(Ox10000) webpages image offset in flash. 


in flash 
(0x30000) linux image offset in flash. 


©2011 Realtek Semiconductor Corp. 


//To configure linux menuconfig 


//customized, should be <= real flash size 


//customized, should not overwrite default 


//customized, should not overwrite current 


//customized, should not overwrite webpage 


//customized, should not overwrite linux image 


//customized, should not overwrite root image 


327 


in flash 
(0Ox100000) root image offset in flash. //customized, should not oversize the end of the 
flash 


system Conriguration 7 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. 
Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, 
</> for Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


Domain name query support 


***x Hardware setting offset,should be 4K alignment *** 
(0x6000) Hardware setting offset in flash. 
*** Default setting offset,should be 4K alignment. *** 
*** size of default and current setting should be same. 
(Ox8000) Default setting offset in flash. 
*** Current setting offset,should be 4K alignment. *** 
(OxcO00) Current setting offset in flash. 
*** Webpage image offset,should be 4K alignment. *** 
**x* size of web page is normally about 100K. *** 
(Ox10000) webpages image offset in flash. 
**x* Linux image offset,should be 4K alignment. *** 
**x*x this offset MUST between 0x10000~0x40000. *** 
(O0x30000) linux image offset in flash. 
*** Root image offset,should be 64K alignment. *** 
0x100000) root image offset in flash. 
(3) Kenel Stack Size Order Configuration 
cer) Ghbalilfel sefeyeiriets (eyeiralfojne) ie] 
File system to mount root (squash fs) 


---> 


7.25 For QoS using htb, something needs to be noticed when set tc rules. 
Answer: 
For QoS using htb to set “Guaranteed minimum bandwidth” rules, the sum of all children rate 
(except the default child rate) should be less than its parent rate. 
One example is as follows: 
tc qdisc del dev ethI root 
iptables -F -t mangle 
tc qdisc add dev eth root handle 2:0 htb default 2 r2q 64 
tc class add dev eth1 parent 2:0 classid 2:1 htb rate 10000kbit ceil 1OOO0Okbit quantum 30000 
tc class add dev eth1 parent 2:1 classid 2:2 htb rate Ikbit ceil 1OO00Okbit prio 256 quantum 30000 
tc qdisc add dev ethI parent 2:2 handle 102: sfq perturb 10 
iptables -A PREROUTING -t mangle -m iprange --src-range 192.168.1.88-192.168.1.89 -j MARK 
--set-mark 13 
tc class add dev eth1 parent 2:1 classid 2:13 htb rate 5000kbit ceil 10000kbit prio 2 quantum 30000 
tc qdisc add dev eth1 parent 2:13 handle 113: sfq perturb 10 
tc filter add dev ethI parent 2:0 protocol ip prio 100 handle 13 fw classid 2:13 
iptables -A PREROUTING -t mangle -m iprange --src-range 192.168.1.60-192.168.1.60 -j MARK 


--set-mark 14 
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tc class add dev eth1 parent 2:1 classid 2:14 htb rate 5000kbit ceil 10000kbit prio 2 quantum 30000 
tc qdisc add dev ethI parent 2:14 handle 114: sfq perturb 10 
tc filter add dev ethI parent 2:0 protocol ip prio 100 handle 14 fw classid 2:14 
echo I > /proc/qos 
For the example above, the sum of all children rate except the default child (2:13 rate 5000kbit + 
2:14 rate 5000kbit) <= its parent rate (2:1 rate 10000kbit). 


7.26 How to configure RTL8192D internal PA? 


Answer: 
There are two flash hardware MIB settings for the internal PA type of each interface on 
RTL8192D. Please check by the following commands: 
flash get HW_WLANO_1I1N_TRSWPAPE_C9 
flash get HW_WLANO_11N_TRSWPAPE_CC 
flash get HW_WLANI1_1I1N_TRSWPAPE_C9 
flash get HW_WLANI_IIN_TRSWPAPE_CC 
The corresponding MIBs at wlan driver can be checked by iwpriv commands as follows: 
iwpriv wlanX get_mib trsw_pape_C9 
iwpriv wlanX get_mib trsw_pape_CC 
The mapping of the flash MIBs and the PA types of RTL8192D is illustrated as the following 
table: 


HW_WLANX_11N_TRSWPAPE_C9 


HW_WLANX_11N_TRSWPAPE_CC 


Type 1: 5G TRSW + Ext. PA, 2G TR 


co-matched (Default) 


0 


0 


Type 2: SG TRSW + Int. PA, 2G TR 170 (=OxAA) 160 (=0xA0) 
co-matched 
Type 3: 5G SP3TSW + Int.PA, 2G TR | 170 (=0xAA) 175 (©OxAF) 
co-matched 
Type 4: 5G TRSW + Int PA, 2G 0 160 (=0xA0) 


TRSW + Int PA 


If the wlan driver can not find the matching settings, the RTL8192D driver will be initialized as 


the Type 1: External PA. 


7.27 How to configure RTL8192C External PA? 


Answer: 


RTL8192C use internal PA as the default setting. If the external PA is wanted to be used, the linux 


kernel configure need to be configured as follows. 


make linux_menuconfig 


Device Drivers ---> 


//To configure linux menuconfig 


[*] Network device support ---> 
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Wireless LAN ---> 


[*] Enable external high power PA 
| Enable external LNA 


Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted lette 


includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> 
[*] built-in [ ] excluded <M> module < > module capable 


Wireless LAN (pre-802.11) 
Wireless LAN (IEEE 802.11) 
Realtek 8190 wireless support 
Realtek 8192SE wireless support 
RTL6192C/D 802.11b/g/n support 
Realtek 8192C wireless support 


= rnal LNA 
Enable Antenna Diversity 


Config File support 
Wireless Tools v29 support 


7.28 How to build image with firmware and config data (without HW setting)? 


Answer: 


First, build CONFIG-DATA with no HW setting. Modify the file : 
users/goahead-2.1.1/LINUX/Makefile or users/boa/defconfig/Makefile if Boa web server is selected. 


/cvcfg-ap $(CONFIG_FILE) $(CONFIG_DAT) 
and 


/evefg-gw $(CONFIG_FILE) $(CONFIG_DAT) 


Add the argument -no_hw 


/cvcfg-ap -no_hw $(CONFIG_FILE) $(CONFIG_DAT) 
and 


/cvcfg-gw -no_hw $(CONFIG_FILE) $(CONFIG_DAT) 
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Then, add config data to firmware image(fw.bin). Modify the file board/rtl8 198 (or 
rtl8196c ,rtl8196ct etc. Depend on CPU)/Makefile 


egrep "\CONFIG_APP_BOA=y" $(DIR_USERS)/.config > BOA.test; \ 
if [ -s BOA.test ] ; then \ 
cp $(DIR_USERS)/boa/himl/$(WEBIMAGE_BIN) 
$(DIR_IMAGE)/$(WEBIMAGE_BIN); \ 
$(MGBIN) -c -o $(FW_BIN) $(ROOT_BIN) $(WEBPAGE_BIN) $(LINUX_BIN); \ 
cd $(DIR_USERS)/boa/defconfig; \ 
mv *.dat $(DIR_ROOT)/boards/rtl8198/image; \ 
cd -; \ 
else \ 
egrep "“CONFIG_APP_GOAHEAD=y" $(DIR_USERS)/.config > GOAHEAD.test; \ 
if [-s GOAHEAD.test ] ; then\ 
cp $(DIR_USERS)/goahead-2.1.1/LINUX/$(WEBIMAGE_ BIN) 
$(DIR_IMAGE)/$(WEBIMAGE_BIN); \ 
$(MGBIN) -c -o $(FW_BIN) $(ROOT_BIN) $(WEBPAGE_BIN) $(LINUX_BIN); \ 
cd $(DIR_USERS )/goahead-2.1.1/LINUX; \ 
mv *.dat $(DIR_ROOT)/boards/rtl81 98/image; \ 
cd -; \ 
fi; \ 
Sis \ 


Move the sentence back and add the argument image/*.dat 


egrep "\CONFIG_APP_BOA=y" $(DIR_USERS)/.config > BOA.test; \ 
if [ -s BOA.test ] ; then \ 
cp $(DIR_USERS)/boa/himl/$(WEBIMAGE_BIN) 
$(DIR_IMAGE)/$(WEBIMAGE_BIN); \ 
cd $(DIR_USERS )/boa/defconfig; \ 
mv *.dat $(DIR_ROOT)/boards/rtl8 198/image; \ 
cd -; \ 
$(MGBIN) -c -o $(FW_BIN) image/*.dat $(ROOT_BIN) $(WEBPAGE_BIN) 
$(LINUX_BIN); \ 


else \ 
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egrep "“CONFIG_APP_GOAHEAD=y" $(DIR_USERS)/.config > GOAHEAD.test; \ 
if [ -s GOAHEAD.test ] ; then \ 
cp $(DIR_USERS )/goahead-2.1.1/LINUX/$(WEBIMAGE_BIN) 
$(DIR_IMAGE)/$(WEBIMAGE_BIN); \ 
cd $(DIR_USERS )/goahead-2.1.1/LINUX; \ 
mv *.dat $(DIR_ROOT)/boards/rtl81 98/image; \ 
cd -; \ 
$(MGBIN) -c -o $(FW_BIN) image/*.dat $(ROOT_BIN) $(WEBPAGE_BIN) 
$(LINUX_BIN); \ 
Si; \ 
fis \ 


At last, rebuild, and the image with firmware and config data (without HW setting) fw.bin will be 
generated. 
Note: Do not upload the image fw.bin with config data via tftp and console (section 3.3), upload it via 


webpage! (section 3.5) 


7.29 What is the firewall capability and the relation with hardware NAT? 
Answer: 


Firewall is based on iptables rule except URL filter. 


Iptables based firewall rules don’t have any relationship with hardware NAT (section 4.12) ; the 


URL filter is conflict to hardware NAT. The hardware NAT will be disabled when the URL filter is 
enabled from WEB UI. 


All the iptables rules are support in kernel, and Port/IP/MAC/URL filter are supported in WEB UI. 
We do the URL filter in fast path. So the fast path MUST be enabled when URL filter is enabled. 


All packets will be trapped to CPU when hardware NAT is disabled. When hardware NAT is 
enabled, the packets will be trapped to CPU if it match a firewall rule, otherwise the packets will be 
transmit by hardware. 


Note: hardware NAT is support by 98/98T/96CT, 96C don’t support this feature. 


7.30 How to enable/disable PPPoE passthru? 


Answer: 

This feature is depend on RTL_CUSTOM_PASSTHRU which enabled by default setting. 

PPPoE pass through (CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE) is disabled by default 
setting. Users can enable it by modify the following codes: 

For kernel 2.6.30 

1) linux-2.6.30/drivers/net/rtl8 19x/12Driver/rtl865x_fdb.h 

#define CONFIG_RTL_CUSTOM_PASSTHRU 

//#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 
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> 

#define CONFIG_RTL_CUSTOM_PASSTHRU 

#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 
2) linux-2.6.30/drivers/net/wireless/rtl8 192cd/8192cd_cfg.h 
#define CONFIG_RTL_CUSTOM_PASSTHRU 
#if defined (CONFIG_RTL_CUSTOM_PASSTHRU) 
//#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 
> 

#define CONFIG_RTL_CUSTOM_PASSTHRU 

#if defined (CONFIG_RTL_CUSTOM_PASSTHRU) 
#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 


For kernel 3.10 
1) linux-3.10/drivers/net/rtl8 19x/12Driver/rtl865x_fdb.h 
#define CONFIG_RTL_CUSTOM_PASSTHRU 
//#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 
> 
#define CONFIG_RTL_CUSTOM_PASSTHRU 
#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 
2) linux-3.10/drivers/net/wireless/rtl8 192cd/8192cd_cfg.h 
#define CONFIG_RTL_CUSTOM_PASSTHRU 
#if defined (CONFIG_RTL_CUSTOM_PASSTHRU) 
//#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 


> 

#define CONFIG_RTL_CUSTOM_PASSTHRU 

#if defined (CONFIG_RTL_CUSTOM_PASSTHRU) 
#define CONFIG_RTL_CUSTOM_PASSTHRU_PPPOE 


SDKv2.5 don’t support enable/disable PPPoE pass through form WEB UI now. Please do the 
following commands when init system. 

1.1) At gateway mode, enable PPPoE passthru as follows: 
ifconfig pethO up 
brctl addif brO pethO 
echo "2">/proc/custom_Passthru or echo "3">/proc/custom_Passthru 

1.2) At gateway mode, disable PPPoE passthru as follows: 
echo "0">/proc/custom_Passthru or echo "1">/proc/custom_Passthru 
brctl delif brO pethO 
ifconfig pethO down 

2.1) At WISP mode, enable PPPoE passthru as follows: 
ifconfig pwlanO up 
brctl addif brO pwlanO 
echo $value > /proc/custom_Passthru_wlan 
where the $value is as follows: 

c) For single band: 


If repeater mode is enabled, $value = 2 | 0x8 = 10; 
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else $value = 2; 

d) For dual band: 
If repeater! enabled or repeater2 enabled, 
$value=2|0x8|((wispWanIld&0xF)< <4), 
else 
$value=2|((wispWanId&0xF)<<4). 
For example: 
Repeater! is enabled, and wispWanId=0, 
$value=2|((O&0xF)<<4)|0x8=10. 


Note: for WISP mode, in order to use PPPoE passthru, nat2.5 should also be enabled, 
otherwise PPPoE passthru will fail. Enable nat2.5 as follows: 
ifconfig wlan0 down 
iwpriv wlanO set_mib nat25_disable=0 
ifconfig wlanO up 
2.2) At WISP mode, disable PPPoE passthru as follows: 
echo "0" > /proc/custom_Passthru_wlan or echo "1" > /proc/custom_Passthru_wlan 
brctl delif brO pwlanO 
ifconfig pwlanO down 


Notel: Please refer to sector 6.3 for more details about custom_Passthru/custom_Passthru_wlan. 


Note2: Please refer to sector 7.14 for more details about ipv6 pass through. 


7.31 How to control dropping unknown multicast packet or not 


1) User could have a choice to drop or forward unknown multicast to unicast packet by the following 


command in console. 

examplel: 

/*to drop unknown multicast to unicast packet*/ 

iwpriv wlanO set_mib mc2u_drop_unknown=1 

example2: 

/*to forward unknown multicast to unicast packet*/ 

iwpriv wlan0 set_mib mc2u_drop_unknown=0 

2) User could have a choice to drop or forward unknown multicast packet 

examplel: 
/*to drop unknown multicast packet*/ 


default to block ipv4 unknown multicast. 
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echo "add all ipv4 0.0.0.0 0x0" > /proc/br_igmpDb 
example2: 
/*to forward unknown multicast packet*/ 


echo "add all ipv4 0.0.0.0 OxFFFFFFFF" > /proc/br_igmpDb 


7.32 How to use AP mib in another application 
Answer: 
If user’s application (not goahead or boa) need to get/set mib through apmib library. The 
following steps should be followed. 
1) Build APMIB as dynamic library 
Modify the Makefile in goahead/LINUX 
users/goahead-2.1.1/LINUX/Makefile 


Set “APMIB_ SHARED = 1” in the Makefile. 


for example: 

#SNMPD support 

ifeq ($(CONFIG_APP_SNMP), y) 

APMIB_SHARED = 1 

else 

APMIB_SHARED = 0 

endif 
2) Linking APMIB dynamic library 

In the application, the header file apmib.h should be included. 

In the application’s Makefile, the apmib.so should be linked. 
3) Using APMIB dynamic library 

Sample code for using the library. 


int main() 


{ 
/*first need to init apmib*/ 


apmib_init(); 


/*then call apmib_get()*/ 
Apmib_get(MIB_ID, value); 


/*if apmib_set() is needed*/ 
Apmib_set(MIB_ID,value); 
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/*if want to write back to flash*/ 
apmib_update(CURRENT_SETTING); 


7.33 How to Support rtl8211ds for RTL8197D High Power demo board 
Answer: 
With rtl8211ds, rtl8 197d will have an Giga wan port. And rtl8211ds is mapping to phy port0. 
Make linux_menuconfig 


-> System Configuration 
-> Support rtl8211ds for rtl8197D 


System Configuration 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> 
includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: 
[*] built-in [ ] excluded <M> module < > module capable 

System Type (97D+92C+92D GW) ---> 


*] Enable watchdog timer support 
[9] Support rt18211lds for rt18197D 
Enable timer adjustment support 
Webpages in rootfs support 

SPI flash support 

*] 819xD clock source at 40Mhz 
Enable Flash Dual Bank support 
USB3G support 

*] Seedup usb samba performance 
Http File server support 

*** Support two spi flash *** 


* 


two spi flash support 
*] Enable Flash Mapping 
*** Flash size 2M or 4M, default 2M *** 
(0x400000) Size of Flash 
*** Hardware setting offset,should be 4K alignment *** 
(0x6000) Hardware setting offset in flash. 
*** Default setting offset,should be 4K alignment. *** 
*** size of default and current setting should be same. *** 
(0x8000) Default setting offset in flash. 
*** Current setting offset,should be 4K alignment. *** 
(OxcO00) Current setting offset in flash. 
v(+) 


< Exit > < Help > 


Note: 1) The function is only supported on SDK3.1 now; 


2) If you are not sure How to support High Power, please refer to section 7.27 . 


7.34 How to adjust the DRAM size 


Answer: 

The size of DRAM depends on bootcode. If 32M is chosen by bootloader, although the size of 
ram is 64M in fact, the size will be considered to be 32M by system. So we need to do configuration 
under bootloader. 


cd bootloader and 
make menuconfig 
->Target Platform Selection //enter 


-> (Dram32M_32Mx1_16bit) is the target of HW Setting //fenter 
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->Dram32M_32Mx1_ 16bit //selected 


(x) >ram32M 32Mx1 16bit 


7.35 How to add applications 


Answer: 
1. Add application to users directory 
Take udhcp for example: 
Copy udhcp-0.9.9-pre to users directory 
2. Edit users/Kconfig 


Add udhcpd support: 


config APP_UDHCPD 
bool "udhcp" 
help 
An embedded DHCP client and server 
Show: 
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When selected, users/.config have line: 
CONFIG_APP_UDHCPD=y 
3. Edit users/Makefile 
Add udhcpd support, add line 
app_$(CONFIG_APP_UDHCPD) += udhcp-0.9.9-pre 
udhcp-0.9.9-pre is the directory name, and CONFIG_APP_UDHCPD is defined in .config 
4. Add romfs target to application’s Makefile 


Edit application’s Makefile to fit Cross Compiling, and add romfs support to collect target 
binary files and config files, use ROMFSINST to install them to romfs. 


romfs: 
$(ROMEFSINST) udhcpd /bin/udhcpd 
mkdir -p $(DIR_LROMFS )/usr/share 
mkdir -p $(DIR_ROMFS )/usr/share/udhcpc 
$(ROMFSINST) -s /var/udhcpc /etc/ 
rm $(DIR_ROMFS )/usr/share/udhcpc/*.deconfig 
$3(ROMESINST) -s /var/udhcpc/br0.deconfig /usr/share/udhcpc/br0.deconfig 
$(ROMESINST) -s /var/udhcpc/eth0.deconfig /usr/share/udhcpc/eth0.deconfig 
3(ROMESINST) -s /var/udhcpc/eth1 .deconfig /usr/share/udhcpc/eth1 .deconfig 
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$(ROMFSINST) -s /var/udhcpc/wlan0.deconfig /usr/share/udhcpc/wlan0.deconfig 
$(ROMFSINST) -s /var/udhcpc/wlan1.deconfig /usr/share/udhcpc/wlan1.deconfig 


$(ROMFSINST) -s /var/udhcpc/wlan0-vxd.deconfig 
/usr/share/udhcpc/wlan0-vxd.deconfig 


$(ROMFSINST) -s /var/udhcpc/wlan 1 -vxd.deconfig 
/usr/share/udhcpc/wlan 1 -vxd.deconfig 


$(ROMFSINST) -s udhcpd /bin/udhcpc 
$(ROMFSINST) -s /var/udhcpd /etc 
5. Make users_menuconfig, select the application, and build image. 


At last run the application on board and hope it works. 


7.36 Howto Enable JFFS2 in the linux and user space for storage partition 


Answer: 


Step 1, add the partitions for /dev/mtd2 in the linux-2.6.30/drivers/mtd/maps/rtl8 19x_flash.c. 
Please add the item to the mtd_partition array ,"rtl8196_parts1". 

If CONFIG_MTD_RTKXX_PARTS enabled ,please refer to 7.53 to add an new partition 
Adjust the CONFIG_JFFS2_SIZE to fit the capacity of the flash. 

For example: 


static struct mtd_partition rtl8196_partsI[] = { 


{ 
name: "boot+cfg+linux", 
size: (CONFIG_RTL_ROOT_IMAGE_OFFSET-O), 
offset: 0x00000000, 
},//mtdo 
{ 
name: "root fs", 
size: (WINDOW_SIZE - CONFIG_RTL_ROOT_IMAGE_OFFSET- 


CONFIG_JFFS2_SIZE ), 
offset: | (CONFIG_RTL_ROOT_IMAGE_OFFSET), 


}, Ymtdl 
//adding the mtd2 
f 
name: "iffs2", Mfor JFFS2 use 
size: (CONFIG_JFFS2_SIZE ), 


offset: (WINDOW_SIZE - CONFIG_JFFS2_SIZE), 
} mtd2 
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} 
Step 2, please enable the following configurations. 


make linux_menuconfig 


->File systems ---> 


[*] | Journalling Flash File System v2 (JFFS2) support 
Miscellaneous filesystems 
Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted 
letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes 
features. Press <Esc><Esc> to exit, <?> for Help, </> for Search. Legend: [*] 
built-in [ ] excluded <M> module < > module capable 


--- Miscellaneous filesystems 


ADFS file system support (EXPERIMENTAL) 

Amiga FFS file system support (EXPERIMENTAL) 

Apple Macintosh file system support (EXPERIMENTAL) 

Apple Extended HFS file system support 

Beos file system (BeFS) support (read only) (EXPERIMENTAL) 
BFS file system support (EXPERIMENTAL) 

EFS file system support (read only) (EXPERIMENTAL) 


Journalling Flash File System v2 (JFFS2) suppc 
JFFS2 debugging verbosity (0 = quiet, 2 = noisy) (NEW) 
JFFS2 write-buffering support (NEW) 
Verify JFFS2 write-buffer reads (NEW) 
JFFS2 summary support (EXPERIMENTAL) (NEW) 
JFFS2 XATTR support (EXPERIMENTAL) (NEW) 
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Step 3, mount JFFS2 partition on the target 
Before accessing JFFS2 file system, you must input the following command on the target as: 
mount —t jffs2 /dev/mtd2. /TARGET_DST_FOLDER. 


7.37 What are the special settings for 11AC? 


Answer: 


The most settings are the same as 11N. The followings are wlan mib for 11 AC: 


1. band 
bit 6 for 11AC. For 11 AC+11N+11A, band = 76 
2. use40M 


2 for 80M mode. For 11AC 80M mode, use40M = 2 
3. Tx power settings, including: 
pwrdiff_20BW1S_OFDM1T_A 
pwrdiff_40BW2S_20BW2S_A 
pwrdiff_SG_20BW1S_OFDMIT_A 
pwrdiff_SG_40BW2S_20BW2S_A 
pwrdiff_SG_80BW1S_160BW1S_A 
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pwrdiff_S5G_80BW2S_160BW2S_A 
pwrdiff_20BW1S_OFDMI1T_B 
pwrdiff_40BW2S_20BW2S_B 
pwrdiff_5G_20BW1S_OFDMI1T_B 
pwrdiff_S5SG_40BW2S_20BW2S_B 
pwrdiff_SG_80BW1S_160BW1S_B 
pwrdiff_S5G_80BW2S_160BW2S_B 
Please refer to MP document for detail of Tx power calibration. 

4. supportedvht 
Set Tx/Rx MCS map of VHT capability element which carried in beacon, probe response, 
association request, and association response. 
Oxfffa: Support 2SS MCS0~9, 1SS MCS0~9 
Oxfff5: Support 2SS MCSO~8, 1SS MCSO~8 
Oxfffe: Support 1SS MCS0~9, 2SS not support 
Oxfffc: Support 1SS MCS0~7, 2SS not support 

5. vht_txmap 
Set VHT Tx rate map for rate adaptive algorithm 
Oxfffff: Support 25S MCS9~0, 1SS MCS9~0 
Ox7ffdf: Support 2SS MCS8~0, 1SS MCS8~0 
Ox3fcff: Support 2SS MCS7~0, 1SS MCS7~0 
Oxfcff: Support 25S MCS5~0, 1SS MCS7~0 

The following are some new flash settings for 11 AC for Tx power calibration: 

TX_POWER_DIFF_20BW1S_OFDMI1T_A 
TX_POWER_DIFF_40BW2S_20BW2S_A 
TX_POWER_DIFF_5G_20BW1S_OFDMIT_A 
TX_POWER_DIFF_5G_40BW2S_20BW2S_A 
TX_POWER_DIFF_5G_80BWI1S_160BWI1S_A 
TX_POWER_DIFF_5G_80BW2S_160BW2S_A 
TX_POWER_DIFF_20BW1S_OFDM1T_B 
TX_POWER_DIFF_40BW2S_20BW2S_B 
TX_POWER_DIFF_5G_20BW1S_OFDMIT_B 
TX_POWER_DIFF_5G_40BW2S_20BW2S_B 
TX_POWER_DIFF_5G_80BWI1S_160BWI1S_B 
TX_POWER_DIFF_5G_80BW2S_160BW2S_B 


Please refer to MP document for detail of Tx power calibration. 


7.38 How to use Band Edge Limit Tables 


Band Edge Limit tables are used to control the amount of increased (even decreased) TPI (Tx Power 
Index) for these specific channels. 
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@ Band Edge Limit Table Format for 92c/92d 


In \rtl8192cd\data\ or \rtl8192cd\data_92d , there are three files for Band Edge Limit Tables. 


Ex. In \rtl8192cd\data’\: 


TXPWR_LMT_92c_1.txt [Region Domain = FCC 


TXPWR_LMT_92c_2.txt [Region Domain = CE 
TXPWR_LMT_92c.txt |Others 


The Format of Band Edge Limit tables is like this 


// Table 2: FCC, OFDM (6M,9M,12M,18M,24M,36M,48M,54M) 
// start from here 

table 2 

1 15.5 15// band edge 

11 13.5 15// band edge 


// 5Gband 1 & 2 
36 16 = 15//band edge 


Target 
15 
15 
I 
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@ Band Edge Limit Table Format for 8812 
The Band Edge Limit Tables for 8812 chip are in \rtl8192cd\data_8812\TXPWR_LMT_8812_new.txt 


In TXPWR_LMT_8812_new.txt, there are 13 Band Edge Limit Tables. 


The Format of Band Edge Limit tables is like this 


// 


// 

## 5G, 80M, 2T, VHT, /(MCS0~MCS9) 
## START 

## #34 FCC ETSI MKK 
//5G Band 1 

CH42 14 15 15 

//5G Band 2 

CH58 13 15 15 

//SG Band 3 

CH106 14 15 15 
CH122 16 15 15 

//5G Band 4 

CH1I55 17 15 NA 

## END 


RegDomain RegDomain 2 RegDomain 
Channel 1 2 
42 14 15 15 
58 13 es) hes 
106 14 bs 15 
122 16 15 15 
155 17 15 NA 


PS 1: NA means NA is non-release channel 
PS 2: Power Limit Value is real dBm. 


PS 2. The power limit value is defined by special restrictions for wireless operation in some countries. 
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@ Howto Add a Band Edge Limit Table for New Regulatory Domain (92c / 92d) 


If chip is 92c, add a new Band Edge Limit in \rtl8192cd\data, format of file name is 
TXPWR_LMT_92c_##.txt where ## is TX Power Limit Table Index (txpwr_Imt_index) 


Ex. Add TXPWR_LMT_92c_3.txt for CCC (China) domain (txpwr_Imt_index=3) 
Add TXPWR_LMT_92c_4.txt for KCC (Korea) domain (txpwr_Imt_index=4) 


If chip is 92c, add a new Band Edge Limit in \rtl8192cd\data_92d, format of file name is 
TXPWR_LMT_92d_##.txt where ## 1s TX Power Limit Table Index 


Ex. Add TXPWR_LMT_92d_3.txt for CCC (China) domain (txpwr_Imt_index=3) 
Add TXPWR_LMT_92d_4.txt for KCC (Korea) domain (txpwr_Imt_index=4) 


@ Howto Add a Band Edge Limit Table for New Regulatory Domain (8812) 
Add new power limit to data_8812/TXPWR_LMT_8812_new.txt in each table 

For example, in table 13: 

// 


// 

## 5G, 80M, 2T, VHT, /(MCS0~MCS9) 
## START 

## #44 FCC ETSI MKK NEW 
//5G Band 1 

CH42 14 15 15 16 

//5G Band 2 

CH58 13 15 15 16 

//SG Band 3 

CH106 14 15 15 16 
CH122 16 15 15 15 

//5G Band 4 

CH155 17 15 NA 16 
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## END 


In this example, 

FCC Domain (txpwr_Imt_index=1) 
ETSI Domain (txpwr_Imt_index=2) 
MKK Domain (txpwr_Imt_index=3) 
NEW Domain (txpwr_Imt_index=4) 


@ Howto assign Band Edge Limit Table for Driver 


As the examples in previous two sections: 


When Regulatory Domain is KCC in wlan1 (92c / 92d), then executing the following command: 


iwpriv wlanl set_mib txpwr_Imt_index=4 


When Regulatory Domain is ETSI in wlan0 (8812), then executing the following command: 


iwpriv wlanO set_mib txpwr_Imt_index=2 


Note that if there are two wlan interfaces, the values of txpwr_Imt_index MIB in the two interfaces all 
need to be configured. 


There are two cases for the txpwr_Imt_index settings 

Case 1: user does not set the value of txpwr_Imt_index (Defaul value, i.e. txpwr_Imt_index = 0), 
IF regdomain = 1 (FCC), FCC TX Power Limit will be applied. 
IF regdomain = 3 (ETSI), ETSI TX Power Limit will be applied. 


IF regdomain = others, Default TX Power Limit will be applied 


Case 2: user set the value of txpwr_Imt_index (txpwr_Imt_index > 0) 


the specified TX Power Limit will be applied. 


Note: 
1. RegionDomain | in data_8812/TXPWR_LMT_8812_new.txt is default TX Power Limit for 
8812. 
data\TXPWR_LMT_92c.txt is default TX Power Limit for 92c. 
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7.39 RTL8367RB LED setting 


The RTL8367RB has 3 LED groups to control the LED behavior, named LEDO, LED1 and LED2. The 
Realtek demo board (include 8197D+8367RB and 8881 AB+8367RB) use RTL8367RB LEDO to 
control Giga LED, and use LED2 to control 10/100M LED for each Ethernet port. If customer uses 
only one LED for each port, please define RTL8367RB_USE_ONE_LED_PER_PORT in 
\linux-2.6.30\drivers\net\rtl8 19x\rtl8367r\rtk_api.c. The LEDO/LED1/LED2 behavior are shown as 
below table. 


Table. RTL8367RB LED Control Register (0x1B03) 


Reg.bit Name Description Mode Default 
n.15 Reserved 
n.14 cfg_set_data_led_en | control cfg_set_data_led enable/disable control W/R OB 
1:enable 
0:disable 
n.13-n.12 cfg_set_data_led write to these two bits will change LED_CFG W/R OOB 


set cfg_data_ledx_cfg as the following table 
set ledO led1 = led2 

00 0010 0011 0100 

O1 O110 O111 1000 

10 0001 0110 1001 

11 1000 O110 O111 


n.11-n.8 cfg_data_led2_cfg | led2 configuration (see ledO configuration). W/R 100B 
n.7-n.4 cfg_data_ledl_cfg | led1 configuration (see ledO configuration). W/R O11B 
n.3-n.0 cfg_data_ledO_cfg | ledO configuration W/R 010B 

0000: LED_Off 0001: Dup/Col 

0010: Link/Act, 0011: Spd1000 

0100: Spd100, 0101: Spd10 

0110: Spd1000/Act, 0111: Spd100/Act 

1000: Spd10/Act 1001: Spd100(10)/Act 

1010: LoopDetect, 1011: eee_cap/eee_Ipi 

1100: Spd1000(100)/Act, 1101: Spd1000(10)/Act 

1110: Master, 1111: 1'bO/Act 


7.40 How to enable GPIOBS as Reset Button for some RTL8196EU-MCM 
reference design 


RTL8196E use GPIOAS as reset button, but some reference design use GPIOBS as reset button, 
this feature can be enabled by a configure option. 


Menu “Enable GPIOBS as Reset Button” is at linux menuconfig as follows: 
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Device Drivers ---> 
[*] Network device support ---> 
[*] | Options for Realtek SoC ---> 
[*] | Enable GPIOBS as Reset Button 


7.41 How to enable SATA interface support on the RTL8198CS platform. 


RTL8198CS has the SATA interface support and this feature can be enabled by a configure 
option. 


Enable the SATA interface at linux menuconfig as follows: 
Device Drivers ---> 
[*] ATA/ATAPI/MFM/RLL support (DEPRECATED) 
[*] Serial ATA and Parallel ATA drivers ---> 
[*] Platform AHCI SATA support 
[*] ATA SFF support (for legacy IDE and PATA) 


7.42 How to use an gpio pin 


Before using an gpio pin, four register need to be set. 
1. set shared pin register 


A certain pin may be versatile with different function, therefore, these shared pins need to be 
configured as gpio mode. 


2. set gpio control register 


The GPIO pins are shared with some peripheral pins, and the type of peripheral can affect 
the attributes of the shared pins. Set control register as gpio pin is needed. 


3. set gpio direction register 


Each GPIO pin may be configured as an input or output pin. Reset button is configured as 
input pin, LED pin is configured as output pin. 


4. set gpio data register 
For output pin(led pin as example), write this register will change the state of pin. 


For input pin(button pin as example),this register value will change with the change of pin 
state. 


Please refer to the datasheet for more information 
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7.43 How to use a GPIO pin via Linux GPIO framework (RTL8197F) 
When BSP has been implemented GPIO chip based on Linux GPIO framework, you have 


two ways to control GPIO pins we provided. First way is via Linux API in kernel space and 
second is via sysfs interface in user spcace. We will take a simple description and usage 


information below. 
In kernel space, you have four basic types of GPIO APIs to control a GPIO pin. 
1. Claiming and releasing GPIOs 
* Ant gqpao request (unsigned: gpi0,. const char *label); 


gpio is the GPIO number you are requesting and Labe1 is just for diagnostic 
purpose. Note that, there is only one requester can own particular GPIO pins, the 
second requester will get return value -EUSY from this API, which means there is 
only one owner can access a particular GPIO pin. 


* void gpio free(unsigned gpioc); 
gpio is the GPIO number you want to release. 
2. GpPIOs direction setting 


* int gpio direction _input(unsigned gpio); 


* int gpio_ direction _output(unsigned gpio, int value); 


gpio is the GPIO number you want to configure as either input or output, and 
value is the initial value when the GPIO direction is configured as output but it 
is not taken effect on our BSP GPIO chip. 


3. GPIOs access 
* int gpio_get_value(unsigned gpio); 
* void gpio_ set _value(unsigned gpio, int value); 


gpio is the GPIO number you are accessing, and value isa binary (0 or 1) 
outputted to the GPIO which has configured as a output pin. 


4. GPIOs mapped to IRQs 
* int gpio_to_irq(unsigned gpio); 


If a GPIO pin mapped to gpio number is the one you want to treat as a interrupt 
input pin, you can use this API to get the IRQ number mapping to gpio number. 


linux-3.10/drivers/char/rtl_gpio.c has some sample code for the GPIO usage of a kernel 
driver through Linux standard framework, and all of GPIO numbers of pin definitions are located 
in linux-3.10/arch/mips/bsp/bspchip.h . 
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In user space, you can access GPIOs through the following sysfs interfaces which are 
distributed over /sys/class/gpio/ directory. 


1 Claiming and releasing GPIOs 


* /sys/class/gpio/export is used for asking kernel to export control of a 
GPIO to userspace by “echo” its number to this file. After successfully exporting a 
GPIO, you will find a gpioN file located in /sys/class/gpio/ directory and 
N is the exported gpio number. 


* /sys/class/gpio/unexport is used for reversing the effect of exporting to 


userspace. 
2  GPIOs Direction Setting 


* /sys/class/gpio/gpioN/direction reads as either “in” or “out”. This 


file may normally be written to change the direction of GPIO pin. 
3 GPIOs access 


* /sys/class/gpio/gpioN/value reads as either 0 (low) or | (high). If the 
GPIO is configured as an output, this value may be written and any nonzero value 
is treated as high. Note that, you canuse active low (see as below) to 
eliminate the dependency of hardware circuit design which uses low potential 
representing function active, which means that 0 always represents non-active and 


1 always represents active, respectively. 


* /sys/class/gpio/gpioN/active low reads as either 0 (false) or 1 (high). 
The initial value is 0 and you can “echo” a non-zero value to invert the value 


attribute both for reading and writing according to your hardware circuit design. 


For more information about the usage of Linux GPIO framework, please refer to 
https://www.kernel.org/doc/Documentation/gpio . 


We also pre-difined GPIO numbers which are reset button, WPS button and system LED in 
the C file gpio.c at boards/rtl8197F/bsp directory. You can specify the pin numbers according to 
your hardware design. An example for modifying, please refer to the following figure: 
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Customer attention ! 
Change pin number here according to 
your hardware design. 


#define BOND_1 /* 97EB*/ 
#define BOND_2 2 /* 97EN*/ 
#define BOND_3 /* 97FS*/ 


#define BSP_RESET_BTN_PIN BSP_GPIO_PIN_C3 
#define BSP_WPS_BTN_PIN BSP_GPIO_PIN_C1 

#define BSP_RESET_LED_PIN BSP_GPIO_PIN_B7 
#define BSP_WPS_LED_PIN BSP_GPIO_PIN_B7 


Example for a customer using reset 
button(pinA1), WPS button(pin A2), 
reset LED(pin A3) and WPS LED(pinA4) 


#define BOND_1 /* 97FB*/ 
#define BOND_2 /* 97EN*/ 
#define BOND_3 /* 97ES*/ 


#define BSP_RESET_BTN_PIN BSP_GPIO_PIN_A1 
#define BSP_WPS_BTN_PINBSP_GPIO_PIN_A2 
#define BSP_RESET_LED_PIN BSP_GPIO_PIN_A3 
#define BSP_WPS_LED_PIN BSP_GPIO_PIN_A4 


7.44 How to build image without default config 


There are some CPU+Wi-Fi IC don’t have demo board and default configuration, users can 


change Wi-Fi according to there request. 
Take 8198+8192E for example. 


1. select 8198 and load default, select config kernel 


[e] Config kernel 


<Select> 
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2. enter linux kernel Wireless LAN menu and select as follows: 


Device Drivers ---> //enter 
[*]Network device support ---> //selected and enter 
Wireless LAN ---> //enter 


Kireless L225 eee 


PCIe Slot 0 device (Realtek 8192EE wireless support ) ---> 


kK elect> 


7.45 How to support LDPC function for 8192ER 
We support LDPC function for 8192ER to get about 2dB gain for coverage or performance. 
However we suggest to enable LDPC function for 8192ER on LDO board only. It it not suitable 
to enable LDPC function for 8192ER on SWR board for system stability. 


To enable LDPC function for 8192ER, please follow the steps: 


1. Find initWlan( ) in users/boa/utils/flash.c. 

2. Find the code segment of getting MIB_WLAN_LDPC_ENABLED to set to wlan mib. 
apmib_get(MIB_WLAN_LDPC_ENABLED, (void *)&intVal) ; 
pmib->dot11nConfigEntry.doti1nLDPC = intVal; 

3. Add the following code after the above code segment. 

sprintf((char *)buf2, "“iwpriv %s set_mib |dpc_92e=%d", ifname, intVal); 
system((char *)buf2); 
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7.46 How to configure 8814A R/8194AR to use 2T2R setting 


@ Configure 8814AR/8194AR to use 2T2R setting by Menuconfig 
m Stepl: make menuconfig in SDK 
mM Step2: select “RTL8198C/8954E+8814+8194 GW” option and load default 
settings 


R Linu; 


menu. 


7-mips-EB-3.10-0.9.33-m32t-13 


Configuration (RTL819 954E+6814+8194 GW) 


[4] Config kernel 


settings 


mM Step3: make | inux_menuconfig and enter to Path > Device Drivers > Network 
device support > Wireless LAN 

m Step4: enable “Real tek 8814/8194 2T2R mode” option as the fol lowing figure 

and save & exit 


- Linux/mi 


orming 


cb buffer management 


<Select> 
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7.47 How to configure hw qos by rtk_cmd 
1. Enable the following config 


a) CONFIG_RTL_HW_QOS_SUPPORT 
make linux_menuconfig 
->DeviceDrivers 
->Network device support(NETDEVICES[=y]) 
-> Options for Realtek SoC (RTL_819X_SWCORE [=y]) 
[*] Support HW Qos 
b) CONFIG_APP_RTK_CMD 
make users_menuconfig 
[*] rtk_cmd daemon 
2. Rtk hw qos cmd 
2.1 Function illustration 
The customer could do “rtk_cmd qos” to implement the configuration for hardware qos. 
2.2 Introduction of Command 
22) QUEUE_NUMBER: 
Set queue number of each port, input the following command in console : 
rtk_cmd qos Queue_Num PORT_NUMI QUEUE_NUMI1 PORT_NUM2 
QUEUE_NUM 2... 
Input para: 
PORT_NUMI QUEUE_NUMI PORT_NUM2 QUEUE_NUM.2... 
Para PORT_NUM1,PORT_NUM2 mean the port you want to set ; 
Para QUEUE_NUM, QUEUE_NUM2 mean the queue number you want to use. 
e.g. if you want to use 2 queues of port0, and use 3queues of portl, then please input 
the command in console:(please follow the format in sample) 
rtk_cmd qos Queue_Num portO 2 port] 3 


If you want to check the queue number of each port, please input the command in 
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console : 
rtk_cmd gos SHOW QUEUE_NUMBER 
2.2.2 © PRIORITY_DECISION: 
ASIC support 5 kinds of priority policy: based on port, dscp, 802.1 p, acl or nat. 
(RTL8197F support an additional priority policy: based on vid.) Please choose one kind 


policy and input the value of decision. Each decision takes up 4 bits. e.g. if you want to set 
port 15 , dscp 1 802.1p2_, acl3, nat4 , (vid5,) please input the following command in 


console: 


rtk_cmd qos Priority_Decision port 15 vlan 1 dscp 2 acl 3 nat 4 (vid 5) 
(Note that the value between port and 15 , vlan and | needa blank. ) 
If you want to check the priority of policies, please input the following command in 
console : 
rtk_cmd gos SHOW PRIORITY_DECISION 
2.2.3  PRIORITY_ASSIGN: 
Now, rtk_cmd qos support 3 kinds policy: Port_Based, Dscp_Based, 802.1p_Based. 
(RTL8197F support an additional policy: Vid_Based.) 
2.2.3.1 Port_Based: 
The priority is assigned by port. If you want to set system priority of portO= 3, system 
priority of portl=4, system priority of port2=5, please input the follow command in console: 
rtk_cmd qos Priority_Assign Port_Based port0 3 port] 4 port2 5 
2.2.3.2 Dscp_Based: 
The priority is assigned by dscp. If you want to set system priority=1 while dscp=10, 
system priority=2 while dscp=61, then input the follow command in console: 
rtk_cmd qos Priority_Assign Dscp_Based dscp10 1 dscp61 2 


If you want to display the priority of each dscp, please input the command in console: 


354 
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rtk_cmd qos SHOW DSCP_BASED_PRI 


2.2.3.3 802.1p_Based: 


If you want to set system priority=2 while vlan priority=1, set system priority=3while 
vlan priority=2, then please input the following command in console: 


rtk_cmd qos Priority_Assign Vlan_Based vlan1 2 vlan2 3 


If you want to check the system priority correspond to each vlan priority, please input the 


following command in console: 


rtk_cmd qos SHOW VLAN_BASED_PRI 
2.2.3.4 Vid_Based: 


If you want to set system priority=2 while vid priority=1, set system priority=3while vid 
priority=2, then please input the following command in console: 


rtk_cmd qos Priority_Assign Vid_Based vid] 2 vid2 3 


If you want to check the system priority correspond to each vlan priority, please input the 


following command in console: 
rtk_cmd gos SHOW VID_BASED_PRI 


Dud PRIORITY_TO_QID : 


Before set the gid correspond to each system priority, please make sure that the queue 
number of each port has been set. If set priority | corresponding to qid 1, priority 2 
corresponding to gid 2, please input the following command in console: 

rtk_cmd qos Priority_to_Qid pril I pri2 2 

If you want to display the mapping relationship between system priority and qid, please 
input the following command in console: 


rtk_cmd gos SHOW PRIORITY_TO_QID 


22 QUEUE_TYPE : 


Queue could be set to two types: STRICT or WEIGHTED. 
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2.2.5.1 STRICT 
If you want to set queueO, queuel and queue2of port! to STRICT type, please input the 
following command in console: 
rtk_cmd qos Queue_Type STRICT port0 q0 ql q2 
If you want to check that which queues of port have been set to STRICT type, please 
input : 
rtk_cmd gos SHOW QUEUE_TYPE_STRICT 
2.2.5.2 WEIGHTED 
If you want to set queueO of port! to WEIGHTED type, and the weight=15; set queuel 
to WEIGHTED type and weight=18, then please input the following command in console: 
rtk_cmd qos Queue_Type WEIGHTED port! q0 15 q1 18 
If you want to check which queues of port have been set to WEIGHTED type, and what 
the weight values are, then please input: 


rtk_cmd gos SHOW QUEUE_TYPE_WEIGHTED 
2.2.6 REMARK: 


ASIC support 2 kinds of remark: VLAN remark and DSCP remark. 
2.2.6.1 WLAN REMARK 
If you want to remark vlan priority=2 when port=0, system priority=1, please input in 
console: 
rtk_cmd qos Remark VLAN port0 pril 2 
If you want to check the information of vlan remark, please input in console : 
rtk_cmd qos SHOW VLAN_REMARK 
2.2.6.2 DSCP REMARK: 
If you want to remark dscp=61, when port=0, system priority=2, please input in 


console: 


©2011 Realtek Semiconductor Corp. 356 


rtk_cmd qos Remark DSCP port0 pri2 61 
If you want to check the information of dscp remark, please input in console: 
rtk_cmd qos SHOW DSCP_REMARK 
2.251 NOTE 
When input the following value in console, please pay attention to the range respective: 
I. vlan priority : 3bit; 
II. system priority: 3bit; 
Ill. port: 3bit; 
IV. dscp value: 6bit; 
V. vid value: 12bit; 


VI. weight: 7bit; 


7.48 How to fix samba “map network driver” disk size show 20M issue 
When test samba performance, usually use samba disk address to “map network driver” to host 


pe. 


We PAR Sah ze 


Windows Al ARIES SAO ase , FPEG 


SIM — ashes. ARERR LIA “HAGE 
|| ees 
Le ees ence cia pee ee 


MDE): w al 
$CHESe (Q); |\4192. 168.1.254\nnti | 


PHO: \\server share 
BRA RHEE Rk) 


In that case, map samba disk size will be root directory disk size. 


For example: 
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Smb.conf 
[mnt] 
comment = Temporary file space 


path = /tmp/usb/ 


[sda] ] 
comment = Temporary file space sdal 


path = /tmp/usb/sda1 


Map \\192.168.1.254\mnt\sdal to local disk, it will show directory “mnt” s’ disk size, in dut 
system mount point is /tmp/usb, usually is 20M 


Map \\192.168.1.254\sdal to local disk, it will show directory “sdal” s’ disk size, in dut system 
mount point is /tmp/usb/sdal1, usually is the real sdal storage disk size. 


In later(sdk 3.4.7) release sdk, usb storage device will be auto mount and the samba directory will 
be auto generated, just be care not map to \\192.168.1.254\mnt\* directory, and the issue will be 
avoid. 


7.49 how to generate firmware of nand flash burning format 
when you want to burn nand flash image with nand flash burning device, you need to 
transform the normal image into burning format image. 
we provides a set of tools to do this function. bch6_eccenc is the tool’s source code. 
how to use 
1. generate the tools binary files 
rtl8198c and rtl8881a/rtl819xd hw ecc is not different, so we need to use different ecc generation 


algorithm. 


for 98c 

cp ecc/98c_ecc.cpp bch6.cpp 
for 888 1a/97d/97dn 

cp ecc/8881la_ecc.cpp bch6.cpp 


make clean;make 
2. how to use this tool 


if you want to package boot,linux and rootfs, this command will be used 
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. /eccenc —-chunk-size 2048 —chunk-per-block 128 —bso 23 —bdo 2000 boot 0 linux. bin 3145728 
squashfs. 0 9437184 


boot 0: burn boot image at 0 offset 
linux. bin 3145728: burn linux.bin image at 3145728 offset 
squashfs. 0 9437184: burn squashfs.o image at 9437184 offset 


3. archives 


burn.bin.ecc: the archive that you can burn with nand flash burning device(this archive 
include hw ecc) 


7.50 how to implement NAT loopback? 


Suppose you’ve setup an ftp server in lanside, you want to allow hosts connected to LAN to 
access the ftp sever on LAN side via its public IP address(WAN IP address), you need setup 
firewall rules for NAT loopback. 


1. firewall rules 
iptables -t nat -A PREROUTING -p tcp -s /Jan_ip -d wan_ip --dport /Jan_server_port -j DNAT 
--to-destination /an_server_ip 
iptables -t nat -A POSTROUTING -p tcp -s /an_ip -d lan_server_ip --dport /an_server_port -j SNAT --to 
wan_ip 
iptables -A FORWARD -d /an_server_ip -i wan_interface -p tcp --dport /an_server_port -j ACCEPT 


lan_ip: ip address of the hosts connected to LAN, want to access the sever on LAN side via its public 
IP address. 


wan_ip: DUT WAN ip address. 
lan_server_port: lan server’s sever port. 
lan_sever_ip: lan sever’s ip address. 


wan_interface: DUT WAN interface name. 


2. example 


Suppose ip address of the hosts connected to LAN is 192.168.1.67, and want to access the ftp 
server(sever ip:192.168.1.100, sever port:21) on LAN side via its public IP address(192.168.9.122).you 
need add the following firewall rules: 

iptables -t nat -A PREROUTING -p tcp -s 192.168.1.67 -d 192.168.9.122 --dport 21 -j DNAT 
--to-destination 192.168.1.100 


iptables -t nat -A POSTROUTING -p tcp -s 192.168.1.67 -d 192.168.1.100 --dport 21 -j SNAT --to 
192.168.9.122 
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iptables -A FORWARD -d 192.168.1.100/32 -i eth1 -p tcp --dport 21 -j ACCEPT 
lan_ip: 192.168.1.67. 

wan_ip: 192.168.9.122. 

lan_server_port: 21. 

lan_sever_ip: 192.168.1.100. 


wan_interface: eth1. 


7.51 How to config watchdog when system startup 


1. disable watchdog 
echo 1| > /proc/watchdog_kick 
kick watchdog 
echo enable 0 intervale 0> /proc/watchdog_cmd 


disable watchdog, donot care interval param. 


2. enable watchdog 
echo enable | intervale 10> /proc/watchdog_cmd 
enable watchdog , watchfog timeout is 10s 
echo | > /proc/watchdog_kick 
kick watchdog 


3. get watchdog status 
cat /proc/watchdog_cmd 


watchdog enable, intervel:83sec,default watchdog_time=10s,max watchdog time=671s 


7.52 About access web server on wan 


From sdk version 3.4.11, access web sever on wan can set web access port in web UI. If enable 
this function and you set web access port as another port, the default web port 80 will be denied. 


For example: 
If you enable access web server on wan and set web access port as 8080, and wan ip address is 
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192.168.2.177, then you can access web server in the following way 192.168.2.177:8080 and cannot 
access web in the following way 192.168.2.177:80. 


7.53 How to add a new partition when rtkxxparts partition table parsing enabled 
Rtkxxparts partition table parsing is a new feature to support mtd partition function if 
CONFIG_MTD_RTKXX_PARTS enabled. 
add an new partition in linux-3.10/drivers/mtd/rtkxxpart.c. 
We only need assign mtd partition size, mtd partition offset is determinated by the rtkxxparts 
mtd parse function. please add partition as follows. 
static struct mtd_partition rtl819x_parts[] = { 


{ 


name: "poot+cfg+linux", 
size: (CONFIG_RTL_ROOT_IMAGE_OFFSET-0), 
offset: 0x00000000, 
}, 
{ 
name: "rootfs", 
size: (RTK_FLASH_SIZE-CONFIG_RTL_ROOT_IMAGE_OFFSET), 
offset: CONFIG_RTL_ROOT_IMAGE_OFFSET, 


}, 
#if CONFIG_RTL_TEST_PARTITION_SIZE != 0 


{ 
name: “test_partition”, 
size: (CONFIG_RTL_TEST_PARTITION_SIZE), 
offset: RTK_FLASH_SIZE 

} 


//dual image releate partition 
#if CONFIG_RTL_TEST_PARTITION_SIZE != 0 


{ 
name: “test_partition2”, 
size: (CONFIG_RTL_TEST_PARTITION_SIZE), 
offset: RTK_FLASH_SIZE 

} 
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#endif 


#endif 


7.54 External module compile method 


Here provides a method to port an external module into SDK. First of all, make sure the external 
module be able to generate expected file before adding into SDK, and then modify the module’s 
Makefile. The mailefile should usually need to assign Linux kernel path and toolchain path, such as 


LINUX_DIR=/home/abc/rtl8 1 9x/linux-3.10 


CROSS=/home/abc//rtl8 19x/toolchain/msdk -4.4.7-mips-EL-3.10-u0.9.33-m32t-140827/bin/mipsel-lin 


ux- 


. The path should be same with the toolchain and kernel location in your computer or server and can be 
accessed. 


After the module adopts correct SDK path, put the module’s directory and files under 
linux-3.10 directory. Finally, add the folder path into linux-3.10 Makefile. For example, the 
external module is in ksock directory, and the linux3.10 makefile should append ksock folder as 


core-y += kernel/ mm/ fs/ ipc/ security/ crypto/ block/ ksock/ 


. Following graph shows the location of ksock directory (new external module) and linux-3.10 
Makefile. 


@System-—Product—Name: ~/ 


vmlinux.o 
README 
REPORTING-—BUGS 


The makefile of external module might be under module’s directory. For instance, the module is ksock, 
and its Makefile is under ksock/. 


99 66 


If all setting is complete, key in “make”, “make modules” or “make linux” command to watch 


compiling result. When correct files are generated by the external module, the setting is successful. 
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7.55 How to adjust Tx/Rx delay of SoC with external Giga PHY/Giga switch 


7.55.1 SoC + External Giga PHY 
SoC: 8197D/8197F 
External Giga PHY: 8211E/8211F/8211FS 


Find out Tx/Rx delay 
RGMII Tx/Rx delay depends on layout and RGMII trace. 
Should find out the best value of Tx/Rx delay for customer’s demo board. 
SoC Tx/Rx delay 
> 8197D: 
Tx delay: register 0xbb80414c bit4, 
Rx delay: register Oxbb80414c bit2~0. 
> 8197F: 
Tx delay: register 0xbb80414c bitl19~18 and bit4, 
Rx delay: register 0Oxbb80414c bit2~0. 


For an example: 
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ew 0xbb80414c 0x37D55 


ew 0xbb80414c 0x37D56 


ew 0xbb80414c 0x37D57 
Should try all the possible Tx/Rx delay combinations and choose the best one with zero CRC 
errors. (Tx delay bit[19:18,4] = 0x0~0x7 and Rx delay bit[2:0] = 0x0~0x7) 


7.55.1.1 External Giga PHY port only 


SoC 
(8197D/8197F) 


If there is only one external Giga PHY port, we can use iperf to find the best Tx/Rx delay 


combination. 
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7.55.1.1.1 How to enable iperf: 


d 


e 


j 
[Wl ipert] 
u 


u 


7.55.1.1.2 Testing Method 
Method: 
> Stepl: Set SoC Tx/Rx delay 
> Step2: Please clear mib counter before iperf test, 
command: echo clear > /proc/rtl865x/asicCounter 
> Step3: Do iperf test for Soc RGMII port. Traffic direction: PC to DUT. 
> Step4: Check SoC port 0 Rx CRC counters 
> Step5: Do the above 4 steps for all Tx/Rx delay combination and choose the best result. 


Check SoC port 0 Rx CRC counters: 
* command: echo dump port 0 > /proc/rtl865x/asicCounter 

<Port: 0> 

Rx counters 
Rev 1142926 bytes, Drop 0 pkts, CRCAlignErr 0, FragErr 0, JabberErr 0 
Unicast 767 pkts, Multicast 0 pkts, Broadcast 1 pkts 
< 64: 0 pkts, 64: 1 pkts, 65 -127: 2 pkts, 128 -255: 0 pkts 
256 - 511: 17 pkts, 512 - 1023: 0 pkts, 1024 - 1518: 748 pkts 
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oversize: 0 pkts, Control unknown 0 pkts, Pause 0 pkts 
Output counters 

Snd 1142926 bytes, Unicast 768 pkts, Multicast 0 pkts 

Broadcast 0 pkts, Late collision 0, Deferred transmission 0 


Collisions 0 Single collision 0 Multiple collision 0 pause 0 


Test Result Example: 


Ea 


Tx delay Tx delay bit4 | Rx delay | Result 
bitl9~18 


has CRC, or iperf cannot run 
has CRC, or iperf cannot run 
has CRC, or iperf cannot run 


fo | Phas GRC, oper camnotrin 


Choose the middle value between 2 and 7, 
=> 8197F Tx delay= 0x1 (bit[19:18,4]), 
8197F Rx delay= 4 or 5. 
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7.55.1.2 External Giga PHY port + Fast Ethernet port 


SoC 
(8197F/8197F) 


\ 
a € 


Chariot test 


7.55.1.2.1 Testing Method 
Method: 
Step1: Set SoC Tx/Rx delay 
Step2: Please clear mib counter before chariot test, 
command: echo clear > /proc/rtl865x/asicCounter 
Do chariot test for SoC RGMII port and FE port 
Check SoC port 0 Rx CRC counters 
Do the above 4 step test for all Tx/Rx delay combination and choose the best 
result. 


Check SoC port 0 Rx CRC counters: 
Command: echo dump port 0 > /proc/rtl865x/asicCounter 

<Port: 0> 

Rx counters 
Rev 1142926 bytes, Drop 0 pkts, CRCAlignErr 0, FragErr 0, JabberErr 0 
Unicast 767 pkts, Multicast 0 pkts, Broadcast 1 pkts 
< 64: 0 pkts, 64: 1 pkts, 65 -127: 2 pkts, 128 -255: 0 pkts 
256 - 511: 17 pkts, 512 - 1023: 0 pkts, 1024 - 1518: 748 pkts 
oversize: 0 pkts, Control unknown 0 pkts, Pause 0 pkts 

Output counters 
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Snd 1142926 bytes, Unicast 768 pkts, Multicast 0 pkts 
Broadcast 0 pkts, Late collision 0, Deferred transmission 0 


Collisions 0 Single collision 0 Multiple collision 0 pause 0 


Test Result Example: 


Ea 


Tx delay Tx delay bit4 | Rx delay | Result 
bitl9~18 


fo 00s | has CRC, or chariot cannot run has CRC, or chariot cannot run 


has CRC, or chariot cannot run 


a ec 
has CRC, or chariot cannot run 

a (a Cee SCO rer 
oii ior 
foodie 
fod 0a CRC och camorn 
fot Ps CR or hit eanctun 
were 
fod were 
fide 
Ce oC 
fois cre 
fod ioc 

Choose the middle value between 2 and 7, 

=> 8197F Tx delay= 0x1 (bit[19:18,4]), 

8197F Rx delay= 4 or 5. 
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7.55.2 SoC + External Giga PHY 
SoC: 8197D/8197F 


External Giga Switch: 8367RB-VB/ 8367R-VB/ 8367RB/8366SC/8363NB/8363NB-VB 


SoC 
(8197D/8197F) 


External Giga switch 
(8367R/8366SC/8363NB) 


Chariot test 


Find out Tx/Rx delay 
RGMII Tx/Rx delay depends on layout and RGMII trace. 


Should find out the best value of Tx/Rx delay for customer’s demo board. 
Tx/Rx delay 


- SoC 
> 8197D: 


Tx delay: register 0xbb80414c bit4, Rx delay: register Oxbb80414c bit2~0. 
> 8197F: 


Tx delay: register Oxbb80414c bit19~18 and bit4, Rx delay: register Oxbb80414c 
bit2~0. 


— External Giga switch 
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> RGMII 1 (8363NB/8364NB/8365MB-VB/8367RB/8367RB- VB) 
Tx delay: register 0x1307 bit3, Rx delay: register 0x1307 bit2~0. 
> RGMII 2 (8364NB/8366SC/8367RB/8367RB-VB)) 
Tx delay: register 0x13c5 bit3, Rx delay: register 0x13c5 bit2~0. 


(Notice that 8364NB/8367RB/8367RB-VB has two RGMII ports, so you should adjust the 


corresponding register to the selected RGMII port on external Giga switch.) 


7.55.2.1 SoC — External Giga switch 
Find out SoC Tx delay and External Giga switch Rx dealy. 


7.55.2.1.1 Testing Method 
Method: 
Step 1: Set SoC Tx delay and External Giga switch Rx delay 


For example: 
Fix SoC Rx delay to 0x5 and External Giga switch Tx delay to 0x0 


air [ [mom [SOS 
Tx Tx Rx Console command 
delay delay delay 
bit19-18 | bit4 
Ox3 ew 0xbb80414c OxF7D45, 
echo 8367write 1307 0 >/proc/rtl865x/phyReg 
Ox3 1 ew 0xbb80414c OxF7D45, 
echo 8367write 1307 | >/proc/rtl865x/phyReg 
ew 0xbb80414c OxF7D45, 
echo 8367write 1307 2 >/proc/rtl865x/phyReg 


ew 0xbb80414c OxF7D45, 
echo 8367write 1307 3 >/proc/rtl865x/phyReg 


ew 0xbb80414c OxF7D45, 
echo 8367write 1307 4 >/proc/rtl865x/phyReg 


Ox3 5 ew 0xbb80414c OxF7D45, 

echo 8367write 1307 5 >/proc/rtl865x/phyReg 
Ox3 ew 0xbb80414c OxF7D45, 

echo 8367write 1307 6 >/proc/rtl865x/phyReg 
Ox3 7 ew 0xbb80414c OxF7D45, 

echo 8367write 1307 7 >/proc/rtl865x/phyReg 
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Ox3 1 ew 0xbb80414c OxF7DS55, 

echo 8367write 1307 0 >/proc/rtl865x/phyReg 
Ox3 1 1 ew 0xbb80414c OxF7DS55, 

echo 8367write 1307 | >/proc/rtl865x/phyReg 
Ox3 1 2 ew 0xbb80414c OxF7DS55, 

echo 8367write 1307 2 >/proc/rtl865x/phyReg 
Ox3 1 3 ew 0xbb80414c OxF7DS55, 

echo 8367write 1307 3 >/proc/rtl865x/phyReg 


ew 0xbb80414c OxF7D55, 
echo 8367write 1307 4 >/proc/rtl865x/phyReg 


Ox3 1 2) ew 0xbb80414c OxF7D55, 

echo 8367write 1307 5 >/proc/rtl865x/phyReg 
Ox3 1 ew 0xbb80414c OxF7D55, 

echo 8367write 1307 6 >/proc/rtl865x/phyReg 
Ox3 1 7 ew 0xbb80414c OxF7D55, 

echo 8367write 1307 7 >/proc/rtl865x/phyReg 


Should try all the possible Tx/Rx delay combinations and choose the best one with zero CRC 


errors. 
(8197F, register Oxbb80414c: Tx delay: bit[19:18,4] = 0x0~0x7 
8367RB, register 0x1307: Rx delay: bit[2:0] = 0x0~0x7) 


Step 2: Do chariot test 
@ Write below command in console 
> echo 0 > /proc/hw_nat 
> echo clear > /proc/rtl865x/asicCounter 
Do chariot LAN/WAN bi-directional test for 30 seconds. 


Step 3: Check Rx CRC count of External Giga switch RGMII port 
> command: echo dump 8367 > /proc/rtl865x/asicCounter 
<CPU port> 
Rx counters 

if[InOctets 527382 
etherStatsOctets 527382 
if[nUcastPkts 0 
etherStatsMcastPkts 67 
etherStatsBcastPkts 838 
StatsFCSErrors 0 
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Step 4: Repeat step | to step 3. 
Do all of the Tx/Rx delay combination and choose the best value. 


Test Result example: 


aioe [ [ao | —SSOSCSCS—S~—S 


Tx Tx Rx Console command 
delay delay delay 
bit19-18 | bit4 


fos foo [wero SOS 
a 


sf fe has CRC, or chariot cannot run 
has CRC, or chariot cannot run 


Choose the middle value between 2 and 7, 
=> 8197F Tx delay= 0x6 (bit[19:18,4]), 
8367RB Rx delay= 4 or 5. 


7.55.2.2 External Giga switch — SoC 
Find out SoC Rx delay and External Giga switch Tx dealy 
Step 1: Set SoC Rx delay and External Giga switch Tx delay 


For example: 
Fix SoC Tx delay to 0x6 (bit[19:18,4]) and External Giga switch Rx delay to 0x5 


pO ew Oxbb804 14c 0xF7D40, 
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a ee echo 8367write 1307 5 >/proc/rtl865x/phyReg 
1 ew 0xbb80414c OxF7D41, 
| Saree a omnes 
2 ew 0xbb804 14c OxF7D42, 
| ners Spchspiata 
3 ew 0xbb804 14c OxF7D43, 
eee 
4 ew 0xbb804 14c OxF7D44, 
| ener sophia 
s) ew 0xbb80414c OxF7D45, 
| tte a meeps 
ew 0xbb804 14c OxF7D46, 
| CinnimiceSpchsatg: 
7 ew 0xbb80414c OxF7D47, 
| Sei tes paki 
1 ew 0xbb80414c OxF7D40, 
eee 
1 1 ew 0xbb80414c OxF7D41, 
eee 
1 2 ew 0xbb804 14c OxF7D42, 
| cnr escheat 
1 3 ew 0xbb80414c OxF7D43, 
eee 
1 4 ew 0xbb80414c OxF7D44, 
| enriching 
ew 0xbb80414c OxF7D45, 
a ee 
ew 0xbb804 14c OxF7D46, 
echo 8367write 1307 d >/proc/rtl865x/phyReg 
ew 0xbb80414c 0xF7D47, 


echo 8367write 1307 d >/proc/rtl865x/phyReg 
Should try all the possible Tx/Rx delay combinations and choose the best one with zero CRC 


errors. 
(8197F, register Oxbb80414c: Rx delay bit[2:0]: 0x0~0Ox7 
8367RB, register 0x1307: Tx delay bit[3]: 0x0~0x1) 


Step 2: Do chariot test 
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@ Write below command in console 
> echo 0 > /proc/hw_nat 
> echo clear > /proc/rtl865x/asicCounter 
Do chariot LAN/WAN bi-directional test for 30 seconds. 


Step 3: Check Rx CRC count of SoC RGMII portO 
> echo dump port 0 > /proc/rtl865x/asicCounter 

<Port: 0> 

Rx counters 
Rcv 0 bytes, Drop 0 pkts, CRCAlignErr 0, FragErr 0, JabberErr 0 
Unicast 0 pkts, Multicast 0 pkts, Broadcast 0 pkts 
< 64: 0 pkts, 64: 0 pkts, 65 -127: 0 pkts, 128 -255: 0 pkts 
256 - 511: 0 pkts, 512 - 1023: 0 pkts, 1024 - 1518: 0 pkts 
oversize: 0 pkts, Control unknown 0 pkts, Pause 0 pkts 


Step 4: Repeat step | to step 3. 
Do all of the Tx/Rx delay combination and choose the best value. 


Test result example: 


[som | aie —OdSOSCSC“‘“~Ss*~“~“~S~S~S~S 
00 Yas eR orcharotcamnormn 
[0 Tis ER orca cannotran 
Tod ioe 
owe 
FO 0 
Toi sider 
oie 
Todor SS 

[0 Ys Ro cat amotio 

[simone 
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Choose the middle value between 2 and 7, 
=> 8197F Rx delay= 4 or 5, 
8367RB Tx delay= 0. 
7.55.3 How to modify Tx/Rx delay in source code 
SoC : 
For 8197F : 
If you need to adjust Tx/Rx delay on 8197F side, you may modify the source code in 
linux-3.10\drivers\net\rtl8 19x\AsicDriver\rtl865x_asicL2.c : 


#if defined(CONFIG_RTL_8197F) && (defined(CONFIG_RTL_8367R_SUPPORT) || 
defined(CONFIG_RTL_83XX_SUPPORT)) 

#define PO_RGMII_TX_DELAY 0 

#define PO_RGMIIT_RX_DELAY 5 


void init_8197f_pO(void) 
{ 
REG32(PCRPO) = (REG32(PCRPO) & ~(ExtPHYID_MASK)) | (5 << ExtPHYID_OFFSET) 
| MIIcfg_ RXER| EnablePHYIf | MacSwReset; 
REG32(PCRPO) = (REG32(PCRPO) & ~(AutoNegoSts_MASK)) | (EnForceMode| 
ForceLink|ForceS peed1000M |ForceDuplex); 


REG32(POGMIICR) = (REG32(POGMIICR) & ~(3<<23)) | (LINK_RGMII<<23); 

REG32(POGMIICR) = (REG32(POGMIICR) & ~((1<<4)|(7<<0))) | 
((PO_RGMII_TX_DELAY<<4) | (PO_RGMII_RX_DELAY<<0) | 
(3<<CF_SEL_RGTXC_OFFSET)); 


} 
#endif 


(3<<CF_SEL_RGTXC_OFFSET) : represents the value of 8197F Tx dealy bit19-18 
PO_RGMII_TX_DELAY : represents the value of 8197F Tx delay bit4 
PO_RGMII_RX_DELAY: represents the value of 8197F Rx delay 


External Giga Switch: 
For RTL8367R : 


If you need to adjust Tx/Rx delay on external giga switch side, you may modify the source code 
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in linux-3.10\drivers\net\rtl8 19x\rtl8367r\rtk_api.c : 


#ifdef CONFIG_RTL_8197F 

// for EMI 
rtl8367b_setAsicReg(0x13C3, 0x0000); 
rtl8367b_setAsicReg(0x13C4, 0x0000); 
rtl8367b_setAsicReg(0x1d53, 0x0001); 
rtl8367b_setAsicReg(0x1d55, Ox000f); 
rtl8367b_setAsicReg(0x1d54, 0x05 fa); 
rtl8367b_setAsicReg(0x1d52, 0x2473); 
rtl8367b_setAsicReg(Ox1d5a, 0x0001); 
rtl8367b_setAsicReg(Ox1d5c, Ox000f); 
rtl8367b_setAsicReg(Ox1d5b, 0x05 fa); 
rtl8367b_setAsicReg(0x1d59, 0x2473); 


rtk_port_rgmiiDelayExt_set(EXT_PORT_FOR_HOST, 0, 5); // change rxDelay to 5 to enhance 
the compatibility of 8197F and 8367RB 


#endif 


0 : represent the value of 8367R Tx delay 


5 : represent the value of 8367R Rx delay 


For other external giga switch (e.g. RTL8366SC/RTL8363NB/RTL8364NB/RTL8365MB-VB) : 


If you need to adjust Tx/Rx delay on external giga switch side, you may modify the source code 
in linux-3.10\drivers\net\rtl8 19x\rtl83xx\rtk_api.c : 


#if defined(CONFIG_RTL_8366SC_SUPPORT) || defined(CONFIG_RTL_8364NB_SUPPORT) 
#define EXT1_RGMII_TX_DELAY 0 

#define EXT1_RGMII_RX_DELAY 6 

#else 

#define EXTO_RGMII_TX_DELAY 0 

#define EXTO_RGMII_RX_DELAY 
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#ifdef ENABLE_8367RB_RGMII2 


#define EXT1_RGMII_TX_DELAY 1 
#define EXT1_RGMII_RX_DELAY 3 
#endif 
#endif 


#if defined(CONFIG_RTL_8367R_SUPPORT) || defined(CONFIG_RTL_8363NB_SUPPORT) || 
defined(CONFIG_RTL_8365MB_SUPPORT) || defined(CONFIG_RTL_8367SB_SUPPORT) 


#define EXTO_RGMII_TX_DELAY_ENABLE_SSC 0 

#define EXTO_RGMII_RX_DELAY_ENABLE_SSC 3 

#elif defined(CONFIG_RTL_8366SC_SUPPORT) || defined( CONFIG_RTL_8364NB_SUPPORT) 
#endif 


You may modify the definition value of Tx/Rx delay depends on which external giga switch you are 


using. 


7.56 How to control the LED of external Switch (Ex: RTL8367RB) 


This section describes how to set the RTL8367RB’s LED to normal/blink/force_off/force_on mode. 


The RTL8367RB has 3 LED groups to control the LED behavior, named LEDO, LED1 and LED2. The 
Realtek demo board (Ex: 8197FS+8367RB) use RTL8367RB LEDO to control Giga LED, and use 
LED2 to control 10/100M LED for each Ethernet port. 

** RTL8367RB register for LEDO, LED1 and LED2: 


LEDO: rgister 0x1b08, 
LED 1: rgister 0x1b0a, 
LED2: rgister 0x1b0c, 
** bit definition for register 0x1b08/0x1b0a/0x1b0c: 
bit O~1: physical port 0 
bit 2~3: physical port 1 
bit 4~5: physical port 2 
bit 6~7: physical port 3 
bit 8~9: physical port 4 
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** bit value for each two bits above: 
0: normal 
1: blink 
2: force off 
3: force on 
** Example: 
The Realtek demo board has 10 Ethernet LEDs and 2 LEDs for each port. 
## set all LEDs to blink: 
$$ Console command: 
echo 8367write 1b08 155 > /proc/rtl865x/phyReg 
echo 8367write 1b0c 155 > /proc/rtl865x/phyReg 


PS, if you do not know that the hardware use which LED group (LEDO/LED1/LED2), you can set all 


of 3 groups to reach your goal, like: 
echo 8367write 1b08 155 > /proc/rtl865x/phyReg 
echo 8367write 1b0a 155 > /proc/rtl865x/phyReg 
echo 8367write 1b0c 155 > /proc/rtl865x/phyReg 
$$ calling the API in SDK: 
Please add the code in the proper place in SDK: 
rtk_led_modeForce_set(LED_GROUP_0, LED_FORCE_BLINK); 
rtk_led_modeForce_set(LED_GROUP_2, LED_FORCE_BLINK); 


## set 2 LEDs of port 2 to blink: 
echo 8367write 1b08 10 > /proc/rtl865x/phyReg 
echo 8367write 1b0c 10 > /proc/rtl865x/phyReg 
## set Giga LED of port 2 to blink: 
echo 8367write 1b08 10 > /proc/rtl865x/phyReg 
## set all LEDs to normal: 
echo 8367write 1b08 0 > /proc/rtl865x/phyReg 
echo 8367write 1b0c 0 > /proc/rtl865x/phyReg 


©2011 Realtek Semiconductor Corp. 


379 


** How to set the blink rate if the LED group is in LED_FORCE_BLINK mode: 


Please use the rtk_led_blinkRate_set(int blinkRate) API. The valid values of input argument blinkRate 


are shown as below: 

enum RTL8367B_LEDBLINKRATE{ 
LEDBLINKRATE_32MS=0, 
LEDBLINKRATE_64MS, 
LEDBLINKRATE_128MS, 
LEDBLINKRATE_256MS, 
LEDBLINKRATE_512MS, 
LEDBLINKRATE_1024MS, 
LEDBLINKRATE_48MS, 
LEDBLINKRATE_96MS, 


LEDBLINKRATE_END, 


7.57 How to enable/disable RGMII SSC of external Switch 


The API for enabling or disabling the RGMII SSC _ of external Switch is 
rtk_port_macForceLinkExtSSC_set(). It is located in /linux-3.10/drivers/net/rtl8 1 9x/rtl83671/rtk_api.c 
or /linux-3.10/drivers/net/rtl8 19x/rtl83xx/rtk_api.c. 


If EMI test is failed, you can try to enable RGMII SSC to pass the EMI test. In case you decide to 
change the SSC state from disable to enable, you need to find out the best RGMII Tx/Rx delay value 


again (refer to section 7.55). 

In v3.4.11C SDK, the following chip combinations have enabled SSC: 
RTL8197F+RTL8367RB 
RTL8197F+RTL8363NB 
RTL8197F+RTL8365MB 
RTL8197F+RTL8367SB 

In v3.4.11C SDK, the following chip combinations have disabled SSC: 
RTL8197F+RTL8364NB 
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RTL8197F+RTL8366SC 


For example, if you want to enable SSC for RTL8197F+RTL8364NB, you can define 
CONFIG_RTL_ENABLE_EXT_SSC in /linux-3.10/drivers/net/rtl819x/rtl83xx/rtk_api.c. Then find 
out the best RGMII Tx/Rx delay value again. 


7.58 How do fwd work to update firmware 


Fwd (firmware write deamon) is a daemon used to update firmware. 


The location of source code is in users/boa/utils/fwd.c, enabled by CONFIG_APP_FWD and 
default enabled in all sdks. 


When update firmware via web ui, upload firmware data saved in a share memory(in 
users/boa/src/read.c write_body() function), and FirmwareUpgrade()(users/boa/src/fmmgmt.c) try 
to analyze the data format, determine the section of firmare data, determine each setcion’s block 
name, offset, length and burn address, save in config fileeFWD_CONF). 


At last, generate another file(/var/fwd.ready) to save share memory id, and boa exist, make fwd 


to complete burn firmware. 


The fwd daemon started on bootup, and timely check file “/var/fwd.ready”, when success to 


read share memory id, it begin to burn firmware. 
The daemon get share memory via id, and get burn info via config fileeFWD_CONF), burn 


firmware sections one by one, and reboot when complete burn. 


7.59 How to add customer hardware setting 


Customer may enable CUSTOMER_HW_SETTING_SUPPORT (apmib.h enable #define 
CUSTOMER_HW_SETTING_SUPPORT) to support customer hardware setting. 


To make sdk backward compatible, hardware setting area have no tlv compress, and can’t 
change. To allow customer auto add/del/change hareware setting, we add the new area 
CUSTOMER_HW_SETTING, which support tlv compress. 


The flash lay out: 
Before add customer hw setting After add customer hw setting 
Boot code(24K) Boot code(24K) 
Hardware setting(8K) Hardware setting(7K) 


Customer hardware setting(1 K) 
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Default setting(16K) Default setting(16K) 


Current setting(16K) Current setting(16K) 


Customer hw setting default 1K, customer may add it if need, but do not overwrite original hw 
setting(original hw setting takes about 5K currently). Customer can add/del/modify the area like 


current setting mib data. 


The feature support after sdk3.4.10 


7.60 How to add default setting in firmware 


When update image, new image may need to change mib setting(add/del/modify mib values). As 
current setting have customer’s own settings, should not be changed, new setting can be set in 
default setting. Normally, new image have no default setting area, to make changes take effect, 
customer need to upload default setting separately. 


Instead of upload default setting, customer may enable DEF_SETTING_IN_FW (default 
enable for 98C), which combine default setting in firware and update firmware means update 
default setting. To make sdk backward compatible, the flash lay out make no change, the default 


setting area still exist but have no use. 
To enable DEF_SETTING_IN_FW in kemmel 3.10 
Make linux_menuconfig 
Machine selection ---> 
System Configuration  ---> 


[ *] default setting in firmware support 


7.61 How to store bluez settings 


The default storage directory of Bluez settings is /var/lib/bluetooth, and it can be adjusted by the 
--localstatedir configure switch. In the section we select default directory as storage directory of Bluez 
settings. 


Select CONFIG_RTL_FLASH_MAPPING_ENABLE& CONFIG_ROOTFS_JFFS2& 
CONFIG_BT_REPEATER_CONFIG in linux-3.10/.config to add bluetooth partition feature, and 
modify CONFIG_RTL_BT_PARTITION_SIZE in linux-3.10/.config to change bluetooth partition 
size. Relevant code is in linux-3.10/drivers/mtd/rtkxxpart.c. 
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Mount bluetooth partition on /var/lib/bluetooth directory utilizing jffs2 filesystem, Relevant code 
is in users/boa/system/set_init.c 
rtl_name_to_mtdblock("bluetooth", bluetoothMtd) ; 


if(btPartErased == @) 
fc 


1 
rtl_name_to_mtdchar("bluetooth", btMtdDev) ; 


sprintf (tmpCmd,"flash_erase -j %s © @",btMtdDev); 
system(tmpCmd) ; 

sleep(1); 

btPartErased = 1; 

apmib_set(MIB_BT_PARTITION_ERASED, (void*)&btPartErased) ; 
apmib_update(CURRENT_SETTING) ; 


5 | 


5 
sprintf(tmpCmd,"mount -t jffs2 %s /var/lib/bluetooth/",bluetoothMtd) ; 
system(tmpCmd) ; 


7.62 How to enable NAT loopback for port forwarding 


Suppose you’ve setup an server in lanside, you want to allow hosts connected to LAN to access 
the sever on LAN side via its public IP address(WAN IP address), please enable the following 


configure in kernel 3.10. 
Make linux_menuconfig 
Location: 
-> Networking support 
-> Networking options 
-> TCP/IP networking 


<*> Realtek support lan client access port forwarding port through wan_ip:fwd_port 


7.63 How to exchange port0 to WAN interface 


In SDK’s default setting, LAN interface (ethO) includes portO ~ port3 and WAN interface (eth1) 
includes port4. If you have the requirement of exchanging port0 to WAN interface and port! ~ port4 to 
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LAN interface, you can achieve the goal by following the steps below : 


1. Make CONFIG_RTL_EXCHANGE_PORTMASK show up by revising 
“/inux-3.10/drivers/net/rtl8 19x/Kconfig” 


#config RTL_BRSHORTCUT_LINUX_VLAN_CTL 


# bool "enable br shortcut when linux vlan enable" 
# default n 
# depends on RTL_VLAN_8021Q 


config RTL_LEXCHANGE_PORTMASK 
bool "exchange portmask from left to right is wan lan1 lan2 lan3 lan4" 


default n 


config RTL_DISABLE_ETH_MIPS16 
bool 
default y 
depends on RTL_819X && !(RTL_8196E && WLAN_HAL_8192EE 


2. Enable CONFIG_RTL_EXCHANGE_PORTMASK 


make linux_menuconfig -> Device Drivers -> Network device support -> Options for Realtek SoC -> 
[*]exchange portmask from left to right is wan lan! lan2 lan3 lan4 


Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing 
<Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for 
Search. Legend: [*] built-in [ ] excluded <M> module < > module capable 


--- Options for Realtek Soc 
ca uto DHCP Check 


onfig MIPS16-Inst Option for Kernel Modules ---> 
onfig for Layered Driver Features ---> 
onfig Multicast Options ---> 


] nable iptables rule to RTL ACL rule 
] nable Ethernet Private Skb 

] upport HW Qos 

] H multicast cam support 

| nable proc filesystem for debug 

] 

] 

] 


ye 


* 


nable JUMBO frame support 
nable rome perf 

ce isable 802.3az EEE feature 

tl ethernet 802.1x support 

ifeemexchange portmask from left to right is wan lanl Jan2 lan3 lan4 


xternal Switch/PHY support (Enable RTL8364NB support) ---> 


acer 


3. make image 
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7.64 How to modify Reserved VLAN ID 


When you set vlan on web UL,if the VID is reserved,you cannot use the vid to set new vlan 


group.In our SDK,we reserve some VID for special use,if you want to use them,please modify the 


value of following variables: 


Variable Default vlaue 
RTL_LANVLANID 9 
/$Kernel/include/net/rtl/rtl865x_netif.h 
RTL_WANVLANID 8 
/$Kernel/include/net/rtl/rtl865x_netif.h 
LAN_VID 9 


/$Kernel/drivers/net/rtl8 1 9x/rtl83671/rtk_api.c 
/$Kernel/drivers/net/rtl8 1 9x/RTL8370_RTL8367_API/rtk_api.c 
/$Kernel/drivers/net/rtl8 1 9x/rtl83xx/ttk_api.c 


WAN_VID 8 
/$Kernel/drivers/net/rtl8 1 9x/rt183671/rtk_api.c 
/$Kernel/drivers/net/rtl8 1 9x/RTL8370_RTL8367_API/rtk_api.c 
/$Kernel/drivers/net/rtl8 1 9x/rt183xx/1tk_api.c 


RTL_LANVLANID_1 9 
/$Kernel/include/net/rtl/rtl_nic.h 

RTL_LANVLANID_2 3 
/$Kernel/include/net/rtl/rtl_nic.h 

RTL_LANVLANID_3 4 
/$Kernel/include/net/rtl/rtl_nic.h 

RTL_LANVLANID_4 5 
/$Kernel/include/net/rtl/rtl_nic.h 

RTL_LANVLANID_5 6 
/$Kernel/include/net/rtl/rtl_nic.h 

RTL_WAN_1_VLANID 10 
/$Kernel/include/net/rtl/rtl865x_netif.h 

RTL_BRIDGE_WANVLANID 7 
/$Kernel/include/net/rtl/rtl865x_netif.h 

RTL_INVALID_WANVLANID 1 
/$Kernel/include/net/rtl/1tl865x_netif.h 

PASSTHRU_VLAN_ID 2 


/$Kernel/drivers/net/rtl8 1 9x/rtl83671/rtk_api.h 
/$Kernel/drivers/net/rtl8 1 9x/rtl83xx/rtk_api-h 
/$Kernel/drivers/net/rtl8 19x/12Driver/rtl865x_fdb.h 


DEFAULT_NAT_LAN_ID 9 
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/users/boa/system/set_linux_vlan.c 


/users/boa/src/fmlinuxvlan.c 


DEFAULT_NAT_WAN_ID 8 


/users/boa/system/set_linux_vlan.c 


/users/boa/src/fmlinuxvlan.c 


$Kernel_dir for kernel 2.6.30 Kernel_dir = linux-2.6.30 


$Kernel_dir for kernel 3.10 Kernel_dir = linux-3.10 


7.65 How to enable 8197f OTG device mode (ether device) 


When you set vlan on web UL,if the VID is reserved,you cannot use the vid to set new vlan 


group.In our SDK,we reserve some VID for special use,if you want to use them,please modify the 
value of following variables: 


1. How to install on PC 


On PC side: 


1.1. run setup.exe on win7 


> autorun_img_tool > autorun_files ¥ 
=, ——— 


Ly PBBRR 


,Y) Driver 
4 autorun 
BY Setup 


__| Setup.exe.manifest 
Setup 
4¢ | Setup 2017/3/30 F 


1.2. make sure setup.exe has been installed. 


() PowerlSO Power Software Ltd 2016/1 

Realtek RTL8196EU Universal Linker Realtek Semicoonductor Corp. 2017/4 
{ Source Insight 3.5 Source Dynamics, Inc. 2017/3 
On Demo board: 


1.3. make sure usb port has no dc output 
1.4. connect demo board usb port to PC usb port 
1.5. enter the following command on console 
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“ifconfig usbO up;brcetl addif brO usb0” 


Then, you will see new network interface in PC 


peu eves Ss aoe ar rRwrye re re VEE we 


0 Bees 7 SH Realtek RTL8196EU Universal Linker 


2. Howto build 


Make linux_menuconfig 


Machine selection ---> 
BSP configuration ---> 
[*] Enable USB controller 
Device Drivers ---> 
[*] USB support ---> 
<*> Support for Host-side USB 
<*> USB Gadget Support ---> 
--- USB Gadget Support 
[] Debugging messages (DEVELOPMENT) 
[] Debugging information files (DEVELOPMENT) 
(2) Maximum VBUS Power usage (2-500 mA) 
(2) Number of storage pipeline buffers 
USB Peripheral Controller ---> 
<*> USB Gadget Drivers (Ethernet Gadget (with CDC Ethernet support)) ---> 
Ethernet Gadget (with CDC Ethernet support) 
[| RNDIS support 
[| Ethernet Emulation Model (EEM) support 
<*> Synopsys DWC_OTG support 
driver version (310a) ---> 
enable debug mode 
HOST ONLY MODE 
DEVICE ONLY MODE 
Enable Realtek usb auto_det control circuit 
Realtek Universal Linker USB support 


Sa hoe 
ee ee ee ee ee 


©2011 Realtek Semiconductor Corp. 


387 


